GPS 调试日志

🔧 GPS 上报调试日志

⚠️ 日志里从来没有出现过「带坐标」的上报（全是注册包 key=...&imei=...）。
说明「定位 → GPS定位」这一页的上报没有发出来。按顺序查，改完必须保存参数 + 断电重启：
① 是否启动 = 启动　② 主动上报网络通道 = 网络通道1　③ 主动上报内容格式 = 自定义
④ 主动上报内容 = lon=${GPSLON}&lat=${GPSLAT}&lont=${GPSLONT}&latt=${GPSLATT}&csq=${CSQ}（开头不要加 &）
⑤ 「网络通道 → 请求的Url」末尾补一个 &　⑥ 更新时间 = 30

排查步骤：
① 点「手动测试」→ 应返回 OK（验证服务器+数据库正常）
② 改 DTU 配置（见下方）→ 保存参数 → 断电重启 DTU → 设备放室外、天线朝天
③ 等 30~60 秒刷新本页 → 新日志 qs 带 &lon=...&lat=... 即成功
④ 看 qs 里 imei 的值后面紧跟的是什么：是 &lon= 才对；若是 862323084278467lon=118.043（黏在一起）⇒ Url 与上报内容之间少了一个 &，去「网络通道 → 请求的Url」末尾补一个 &（见下表第 2 行）
⑤ 只有注册包（OK(REG)）时不要急着改配置：先看「响应 / 判定」列的尾部提示 —— 写"定位上报已触发但无坐标"是 GPS 没定位；写"只收到 key+imei"才是 上报没在跑

日志表现	含义与处理
qs 带 `&lon=...&lat=...` → OK	✅ 坐标已入库，一切正常
qs 里 `imei=862...467lon=118.043` 黏在一起（imei 后面少了 `&`） → OK(GLUE) 或 CONFIG ERROR	❌ Url 与「主动上报内容」之间少了一个 `&`。 DTU 是把上报内容直接拼在「请求的Url」后面的，不会自动补分隔符： Url 末尾 `...&imei=862323084278467` ＋上报内容 `lon=118.043...` ⇒ `...imei=862323084278467lon=118.043...`，结果 imei 的值被污染、lon 参数根本不存在，服务器只能回 OK(NO FIX)。 ✅ 推荐改法（最安全）：在「网络通道 → 请求的Url」末尾补一个 `&` `/gps/api/upload.php?key=gps2026&imei=862323084278467&`　← 末尾这个 `&` 「主动上报内容」保持原样，不要在它开头加 `&`。 ⚠️ 2026-09-13 实测：往「主动上报内容」开头加 `&` 之后，定位上报整条静默（改那个框容易连带动坏「是否启动」）。新版 upload.php 已能自动容错（坐标照样救回来入库、响应标 OK(GLUE)），但仍请按上面改配置根治。
qs 带 `{"imei":...,"csq":..}` → OK(REG)	🟡 设备已连上服务器（这是注册包，不含坐标，属正常现象）。若长期只有注册包、没有任何带坐标的记录：① 看设备 1PPS/GPS 指示灯是否 1 秒闪烁（闪=定位成功，不闪=未定位）； ② 设备必须移到室外空旷处，无源陶瓷天线正面朝天（室内定位不了，冷启动 23~35 秒，首次可能几分钟）； ③ 再检查「定位 → GPS定位」是否启动=启动、格式=自定义、上报网络通道=网络通道1
qs 里出现两个 `imei=`（或两个 `key=`）→ CONFIG ERROR	❌ 你把 `imei=${IMEI}`（或 `key=`）填进了「定位 → GPS定位 → 主动上报内容」。该框只能填 GPS 变量：`&lon=${GPSLON}&lat=${GPSLAT}&lont=${GPSLONT}&latt=${GPSLATT}&csq=${CSQ}` key / imei 属于「网络通道 → 请求的Url」，两个框不要混。
qs 只有 `key=&imei=` → OK(NO FIX)	❌ 设备能连但没有坐标。新版 upload.php 会把日志再细分，看日志尾部有没有内容： ① 尾部还有内容（例 `&imei=...&csq=22`、`&lon=&lat=`） ⇒ 定位上报确实在跑，就是 GPS 没定位 → 看 1PPS LED 是否 1 秒闪 + 天线朝天； ② 尾部什么都没有、只有 `key+imei` ⇒ 「定位」页的上报根本没在跑 → 查「是否启动=启动」「上报网络通道=网络通道1」，改完必须保存参数 + 断电重启； ③ 若 imei 与 lon 黏成一条 ⇒ 见上面第 2 行（缺 `&`）
KEY ERROR	❌ Url 里漏了 `key=gps2026`
日志一片空白	❌ 请求根本没进 PHP：DTU 必须配 https:// + 端口443 + 支持SSL=加密（服务器已强制 http→https 跳转，DTU 不跟随重定向）；也可能设备离线/SIM 欠费

日志表现

含义与处理

qs 带 &lon=...&lat=... → OK

✅ 坐标已入库，一切正常

qs 里 imei=862...467lon=118.043 黏在一起
（imei 后面少了 &）
→ OK(GLUE) 或 CONFIG ERROR

❌ Url 与「主动上报内容」之间少了一个 &。
DTU 是把上报内容直接拼在「请求的Url」后面的，不会自动补分隔符：
Url 末尾 ...&imei=862323084278467 ＋上报内容 lon=118.043... ⇒ ...imei=862323084278467lon=118.043...，
结果 imei 的值被污染、lon 参数根本不存在，服务器只能回 OK(NO FIX)。
✅ 推荐改法（最安全）：在「网络通道 → 请求的Url」末尾补一个 &
/gps/api/upload.php?key=gps2026&imei=862323084278467&　← 末尾这个 &
「主动上报内容」保持原样，不要在它开头加 &。
⚠️ 2026-09-13 实测：往「主动上报内容」开头加 & 之后，定位上报整条静默（改那个框容易连带动坏「是否启动」）。
新版 upload.php 已能自动容错（坐标照样救回来入库、响应标 OK(GLUE)），但仍请按上面改配置根治。

qs 带 {"imei":...,"csq":..} → OK(REG)

🟡 设备已连上服务器（这是注册包，不含坐标，属正常现象）。
若长期只有注册包、没有任何带坐标的记录：① 看设备 1PPS/GPS 指示灯是否 1 秒闪烁（闪=定位成功，不闪=未定位）； ② 设备必须移到室外空旷处，无源陶瓷天线正面朝天（室内定位不了，冷启动 23~35 秒，首次可能几分钟）； ③ 再检查「定位 → GPS定位」是否启动=启动、格式=自定义、上报网络通道=网络通道1

qs 里出现两个 imei=（或两个 key=）→ CONFIG ERROR

❌ 你把 imei=${IMEI}（或 key=）填进了「定位 → GPS定位 → 主动上报内容」。
该框只能填 GPS 变量：&lon=${GPSLON}&lat=${GPSLAT}&lont=${GPSLONT}&latt=${GPSLATT}&csq=${CSQ}
key / imei 属于「网络通道 → 请求的Url」，两个框不要混。

qs 只有 key=&imei= → OK(NO FIX)

❌ 设备能连但没有坐标。新版 upload.php 会把日志再细分，看日志尾部有没有内容：
① 尾部还有内容（例 &imei=...&csq=22、&lon=&lat=） ⇒ 定位上报确实在跑，就是 GPS 没定位 → 看 1PPS LED 是否 1 秒闪 + 天线朝天；
② 尾部什么都没有、只有 key+imei ⇒ 「定位」页的上报根本没在跑 → 查「是否启动=启动」「上报网络通道=网络通道1」，改完必须保存参数 + 断电重启；
③ 若 imei 与 lon 黏成一条 ⇒ 见上面第 2 行（缺 &）

KEY ERROR

❌ Url 里漏了 key=gps2026

日志一片空白

❌ 请求根本没进 PHP：DTU 必须配 https:// + 端口443 + 支持SSL=加密（服务器已强制 http→https 跳转，DTU 不跟随重定向）；也可能设备离线/SIM 欠费