charging-cabinet/test/tcp_latency_probe.py
12451 471b61d277 fix(test)+fix(deploy)+docs: 探针状态语义反转修复、退出码补齐、文档校订
1) probe_export.py:任务状态语义**搞反了**(导出成功也会被判失败)
   - download_tasks.status 的权威语义是 0 排队 / 1 处理中 / **2 完成** / 3 失败
     (db/migrate.rs:225 列注释;写入侧 charge_records.rs::mark_task_completed 写的就是 2)。
   - 该脚本此前**等 status == 1(处理中)当成功、把 status == 2(完成)判成"导出失败"**
     —— 典型假红。已按权威语义订正,并与另外两处**本来就正确**的口径对齐:
     web/src/pages/charge-records/DownloadCenter.tsx::statusText、
     test/schema_alignment_e2e.py(等 status in (2,3) 再断言 == 2)。
   - 同批修正退出码分类:账号缺 charge_record:export(403)由 exit 1 改为
     **exit 2「未验证」** —— 本项要验证的是"降权成 pms 后能否往 exports/ 落盘",
     没权限根本走不到那一步,报 1 是**把夹具缺陷说成产品缺陷**(误报与假绿同样有害)。
   - 允许用 PMS_PROBE_PHONE / PMS_PROBE_PASSWORD 换成有权限的账号。
   - **C 项结论(由落盘物证直接判定,不依赖该脚本)**:测试环境
     exports/充电记录__-.xlsx 5559 B、生产同类产物 5457 B,属主均为 pms:pms;
     两环境 exports/uploads 目录均 pms:pms,两 api-server 单元均 User=pms/Group=pms
     ⇒ 降权进程确实能落盘。已在 README 写明并给出取证依据。

2) deploy-prod.ps1 的退出码(此前失败的探针只打印 ❌ 就继续,脚本仍以 0 退出)
   - 消费链路探测失败(exit 1)现在**记入失败清单**并以 exit 1 收尾;
     "未验证"(隧道没起)默认仍不计失败(环境问题会误报),
     但新增 **-StrictVerify** 开关供 CI/无人值守使用,打开即 exit 1。
   - 好处:把这条从"打印了 ❌ 却 exit 0"(仓库第 8 条假绿)里摘出来。

3) 统一退出码 0/1/2 落地到本批脚本,并对每个失败路径实测取证:
   - test/tcp_e2e_smoke.py:13/13 通过(含未登录业务报文被静默丢弃);先复位夹具再跑。
   - test/security-hardening/ 新增 verdict.py 判据容器(未跟踪 → 本次入库);
     4 个探针全部按失败→exit 1 改造,并各实测过失败路径。
   - 实测结果(2026-09-20 发布后回归):smoke_prod 4/4 exit 0、
     probe_prod 5/5 exit 0、probe_upload 6/6 exit 0。

4) 工具与文档
   - tools/db.py 默认库由**生产 pms 改为测试 pms_dev**(可用 PMS_MYSQL_DB 覆盖,
     切生产时打印醒目警告)—— "以为在测测试库、实际打生产"的隐患。
   - tools/db_schema_diff.py:连不上必须是 exit 2,绝不伪装成"无漂移"的 0。
   - 新增 tools/dev-tunnel.ps1(入库,SSH 隧道;口令走 PMS_SSH_PASSWORD 环境变量),
     配套 tools/dev-tunnel-run.ps1 自愈启动器**保持 gitignore**(内含口令)。
   - deploy/nginx/nginx.conf 镜像随线上同步(移除 stream 转发;与线上逐字节一致)。
   - AGENTS.md / README.md:补「踩过的坑」第 7/8 条(掐断上游管道会杀被测进程、
     打印 ❌ 却 exit 0 是假绿)、退出码约定、本地开发改 SSH 隧道、
     在线判据口径订正、order_timeout 守门补齐、小程序 vue-tsc 门禁与其抓到的两个真 BUG。

发布验收(本次统一发布,按 device→api 顺序):
- 测试环境与生产环境四服务 active,端口 9000/9001/3000/3001 正确,ERROR 均为 0;
- 生产迁移按判据 grep '更新列注释' 实测对齐 cabinets.status 列注释;
- 结构漂移 python tools/db_schema_diff.py = 0 处漂移 / exit 0(--vs-ddl 两库同样 0);
- schema_alignment_e2e --env dev 全部通过 exit 0;
- 生产域名 /api/pms/cabinets -> 401、/pms/ -> 200;消费链路探测通过。
2026-09-20 04:31:42 +08:00

117 lines
4.6 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

"""测量端到端真实延迟:发一条 auth_str,看应答多久到达(最长等 75 秒)。
退出码(全仓统一口径):0 = 三步都有应答;1 = 有步骤无应答/断言失败;
2 = 连接或环境问题(DB 连不上、TCP 建连失败)。
⛔ 以前它只打印 ✅/❌ 却永远 exit 0 —— 无应答也算"通过",属假绿。
"""
import hashlib
import json
import os
import socket
import sys
import time
import pymysql
# 3001 是 device-server 的 TCP 业务端口(设备经公网/ZeroTier 直连),与数据库通路无关,保持不变
HOST, PORT = "10.8.0.252", 3001
IMEI = "860000000000001"
# 复位夹具,保证能重新申领
# 默认指向 SSH 隧道(tools/dev-tunnel.ps1),不再使用已移除的 ZeroTier/nginx 转发
try:
conn = pymysql.connect(host=os.environ.get("PMS_MYSQL_HOST", "127.0.0.1"),
port=int(os.environ.get("PMS_MYSQL_PORT", "13306")),
user="root", password="Hbhyg731024@",
database="pms_dev", connect_timeout=8, autocommit=True)
except pymysql.MySQLError as e:
print(f"✗ MySQL 连接失败:{e}", file=sys.stderr)
print("连接被拒:请先运行 `pwsh tools/dev-tunnel.ps1` 建立 SSH 隧道", file=sys.stderr)
sys.exit(2)
cur = conn.cursor()
cur.execute("UPDATE cabinets SET auth_str=NULL, auth_str_issued=0 WHERE imei=%s", (IMEI,))
cur.execute("DELETE FROM charge_records WHERE cabinet_id=1")
cur.execute("DELETE FROM charge_orders WHERE cabinet_id=1")
cur.execute("DELETE FROM device_logs WHERE cabinet_id=1")
cur.execute("DELETE FROM batteries")
cur.execute("UPDATE compartments SET status=0")
conn.close()
print(" 夹具已复位")
try:
s = socket.create_connection((HOST, PORT), timeout=5)
except OSError as e:
print(f"✗ TCP 建连失败 {HOST}:{PORT}:{e}", file=sys.stderr)
print("(该端口是 device-server 业务端口;测试环境为 :3001)", file=sys.stderr)
sys.exit(2)
s.settimeout(1.0)
buf = b""
fails = [] # 收集失败项,决定退出码(非 0 = 失败)
def send(obj):
line = json.dumps(obj, separators=(",", ":")) + "\n"
s.sendall(line.encode())
return time.time()
def wait_reply(t0, timeout=75):
"""等到收到一行报文,返回 (耗时, 报文) 或 (None, None)。"""
global buf
while time.time() - t0 < timeout:
try:
chunk = s.recv(65536)
except socket.timeout:
continue
if not chunk:
return None, None
buf += chunk
if b"\n" in buf:
line, buf = buf.split(b"\n", 1)
return time.time() - t0, json.loads(line.decode())
return None, None
print("\n=== ① auth_str 延迟实测 ===")
t0 = send({"act": "auth_str", "msg_id": 1, "dev_id": IMEI})
dt, resp = wait_reply(t0)
if resp:
print(f" ✅ 应答耗时 {dt:.1f}s : {json.dumps(resp, ensure_ascii=False)}")
auth_str = resp.get("auth_str")
if not auth_str:
fails.append("① auth_str 有应答但未带 auth_str")
else:
print(f" ❌ {dt if dt else '>75'}s 内无应答")
auth_str = None
fails.append(f"① auth_str 无应答(等待 {dt if dt else '>75'}s)")
if auth_str:
print("\n=== ② login 延迟实测 ===")
ts = int(time.time())
sign = hashlib.sha256(f"{IMEI}{auth_str}{ts}".encode()).hexdigest()[56:64]
t0 = send({"act": "login", "msg_id": 2, "dev_id": IMEI, "sign": sign, "timestamp": ts})
dt, resp = wait_reply(t0)
print(f" {'✅' if resp else '❌'} 应答耗时 {dt:.1f}s : {json.dumps(resp, ensure_ascii=False) if resp else '无'}")
if not resp:
fails.append(f"② login 无应答(等待 {dt if dt else '>75'}s)")
print("\n=== ③ status_post 延迟实测 ===")
t0 = send({"act": "status_post", "msg_id": 3, "rssi": 85,
"cabinet": {"status1": "00", "status2": "00", "temp": 29800, "meter": 125500},
"boards": [{"board": 1, "channels": ["008200000000000000", "008200000000000000"]},
{"board": 2, "channels": ["008200000000000000", "008200000000000000"]}]})
dt, resp = wait_reply(t0)
print(f" {'✅' if resp else '❌'} 应答耗时 {dt:.1f}s : {json.dumps(resp, ensure_ascii=False) if resp else '无'}")
if not resp:
fails.append(f"③ status_post 无应答(等待 {dt if dt else '>75'}s)")
s.close()
# ⛔ 退出码必须反映结果(口径:0=通过,1=断言失败,2=环境/连接问题)
if fails:
print("\n未通过项(stderr):", file=sys.stderr)
for f in fails:
print(f" ❌ {f}", file=sys.stderr)
sys.exit(1)
print("\n✅ 三步均有应答")
sys.exit(0)