From ed40942a4cf56de6b5c019c0139d1449be1f71dd Mon Sep 17 00:00:00 2001 From: Tory Date: Mon, 16 Nov 2026 13:45:56 +0800 Subject: [PATCH] =?UTF-8?q?docs(issue#3):=20SrcID=20=E6=A0=B8=E9=AA=8C?= =?UTF-8?q?=E8=A3=81=E5=AE=9A=E6=96=B9=E6=A1=88C(=E5=89=8D=E7=BC=80+?= =?UTF-8?q?=E5=8A=A8=E6=80=81=E6=89=A9=E5=B1=95)=E2=80=94=E2=80=94s2demo?= =?UTF-8?q?=20=E9=85=8D=E7=BD=AE=20ext=5Fcode=3D10690331=20+=20=E7=9C=9F?= =?UTF-8?q?=E6=9C=BA=E5=9B=9B=E5=9C=BA=E6=99=AF=E5=AE=9E=E8=AF=81=20+=2030?= =?UTF-8?q?s=20=E7=BC=93=E5=AD=98=E5=8F=A3=E5=BE=84=E7=95=99=E7=97=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CHANGELOG.md | 3 ++- memory-bank/activeContext.md | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index ea8e6f1e..eb351505 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,7 +8,8 @@ - **CMPP -1 根因**:`ConnectResp.Marshal` 把 Status 按 **1 字节**编码(18B 包体)= CMPP **3.0** 布局;而 **CMPP 2.0 规范 CMPP_CONNECT_RESP.Status 为 4 字节整数**(21B 包体;两版本恰与 SUBMIT_RESP.Result 互为镜像——2.0 Result=1B、3.0=4B,本项目 SubmitResp 按 2.0 实现且与真实上游联调通过,唯独 ConnectResp 误用 3.0 布局)。标准 2.0 客户端按 4B 大端解析读到 [status,MD5[0..2]] **恒非 0** → 客户端工具报 -1;自家客户端同按 1B 解析,自测格式对称掩盖缺陷(与 Day39 Submit 布局坑同构:模拟网关与实现同源同错)。 - **修复(body.go)**:①`Marshal` Status 4B 大端(21B 包体);②`AuthenticatorISMG` 中 Status 以 4B 参与 MD5(2.0 规范);③`ParseConnectResp` 自适应双布局(≥20B 按 2.0 4B;17~19B 按 3.0 1B 兼容;短包取首字节)——自家客户端连真实上游 2.0 网关不再靠「status=0 时 b[0] 恰为零」侥幸,拒绝码也能正确读出。 - **充值无响应根因(双重)**:①前端 `accountApi.recharge` 发 `{count,remark}`,后端 `rechargeReq` 要求 `{amount}`(`binding:"required,gt=0"`)→ 恒 400;②`AccountRecharge.vue` submit 无 catch,BizError 被静默吞掉 → 点击零反馈。修复:API 字段对齐 amount+mock 契约同步(msw handlers)+submit catch 提示(含 acc 未装载 warning 分支)。 -- **SrcID 核验口径**:CMPP 2.0 协议 Src_ID 定长 21 字节(协议层硬约束,parse 天然截断);平台核验=账号 ext_code 非空时前缀匹配(不匹配回 Result=9,s2demo 未配置故未生效)。AccountDetail 两处文案(接入信息+交付文本)明确「定长 ≤21 位+ext_code 前缀规则」,动态显示账号 ext_code。 +- **SrcID 核验口径(用户裁定:方案 C 前缀+动态扩展,行业惯例)**:CMPP 2.0 协议 Src_ID 定长 21 字节(协议层硬约束,parse 天然截断);平台核验=账号 ext_code 非空时前缀匹配(不匹配回 Result=9)。**s2demo 已配置 ext_code=10690331**(通道接入码即分配前缀):客户 SrcID 须以 10690331 开头,可追加自定义扩展位(总长 ≤21,扩展 ≤13 位)区分业务——纯下发填 10690331,带扩展填 10690331xxx。AccountDetail 两处文案(接入信息+交付文本)明确「定长 ≤21 位+ext_code 前缀规则」,动态显示账号 ext_code。 +- **方案 C 真机四场景实证**(第三方 2.0 探针,余额 0 零副作用):纯接入码 10690331→Result=10(过码校验,欠费拒);接入码+扩展 10690331001→Result=10(**前缀+动态扩展通过**);不匹配 10699999→Result=9;空 SrcID→Result=9。日志双事件留痕(cmpp_submit_src_prefix_mismatch/cmpp_submit_rejected)。**运营口径:ext_code 变更后受理热路径账号缓存 30s 内生效**(Day63 accCache TTL;真机首验踩到,等 30s 后四场景全中)。 - **真机实证**:标准 2.0 客户端探针(纯标准库,4B 解析视角)——修复前 18B/Status=3222621(复现 -1);修复后(串行 build→kill→md5 部署)21B/Status=0 连接成功 ✓,错误密码 Status=2(标准语义码);充值 curl:count→ISC:400(复现被吞报错)/amount→ISC:000 余额 0→100 ✓,冒烟数据已还原。 - **顺手修**:TestClient_LoginOK 时序竞争(网关 logins.Add 在 WritePacket 后,客户端握手完成与落账存在调度窗口,全量 -race 并行下偶发 0)→ 轮询 1s 吸收;全量复跑 **41 包全绿**。 - **门禁**:vet 0/-race 41 包/lint 0;eslint 0/vue-tsc 0/vitest **165**/build 9.88s。 diff --git a/memory-bank/activeContext.md b/memory-bank/activeContext.md index a323cad6..a89af93f 100644 --- a/memory-bank/activeContext.md +++ b/memory-bank/activeContext.md @@ -2,7 +2,7 @@ ## 当前状态快照(2026-11-16,**Issue#3 已修复入库,S4 泳道收官,一期 18/27 计划日**) -- **Issue#3 三连修复(2026-11-16 晚)**:①CMPP 连接报 -1 根因=`ConnectResp` 误按 **3.0 的 1B Status** 编码(标准 2.0 客户端按 4B 大端解析恒非 0)→ 修复=Marshal 4B(21B 包体)+AuthenticatorISMG 4B 参与 MD5+`ParseConnectResp` 自适应双布局(≥20B/2.0,17~19B/3.0);标准 2.0 探针真机实证 18B/垃圾值→21B/Status=0,**教训:2.0 与 3.0 在 CONNECT_RESP.Status/SUBMIT_RESP.Result 上互为镜像(2.0=4B/1B),自家 client+server 同源对称自测掩盖协议错位——同 Day39 坑**;②充值无响应=前端发 `{count}` 后端要 `{amount}`+submit 无 catch 静默吞错 → API/mock/组件三处修复;③SrcID 核验口径=协议定长 21B+ext_code 前缀校验,AccountDetail 文案明确。顺手修 TestClient_LoginOK 时序竞争(轮询吸收);门禁 -race 41 包/vitest 165/build 全绿;gateway 已串行部署(md5 比对 ✓)。 +- **Issue#3 三连修复(2026-11-16 晚)**:①CMPP 连接报 -1 根因=`ConnectResp` 误按 **3.0 的 1B Status** 编码(标准 2.0 客户端按 4B 大端解析恒非 0)→ 修复=Marshal 4B(21B 包体)+AuthenticatorISMG 4B 参与 MD5+`ParseConnectResp` 自适应双布局(≥20B/2.0,17~19B/3.0);标准 2.0 探针真机实证 18B/垃圾值→21B/Status=0,**教训:2.0 与 3.0 在 CONNECT_RESP.Status/SUBMIT_RESP.Result 上互为镜像(2.0=4B/1B),自家 client+server 同源对称自测掩盖协议错位——同 Day39 坑**;②充值无响应=前端发 `{count}` 后端要 `{amount}`+submit 无 catch 静默吞错 → API/mock/组件三处修复;③SrcID 核验**用户裁定方案 C(前缀+动态扩展,行业惯例)**——s2demo 已配 ext_code=10690331(通道码即前缀),客户 SrcID 须以 10690331 开头+可追加扩展(≤21 位);真机四场景实证(纯码→10 过/码+扩展→10 过/不匹配→9/空→9);**运营口径:ext_code 变更后 30s 缓存生效(Day63 accCache)**。顺手修 TestClient_LoginOK 时序竞争(轮询吸收);门禁 -race 41 包/vitest 165/build 全绿;gateway 已串行部署(md5 比对 ✓)。 - **仓库**:main 已推 Gitea;每日 bundle+push 双轨。 - **一期进度**:S0✅ S1✅ S2✅ / S3 ✅(11-15 凌晨)/ **S4 ✅ 收官(11-16,三项验收全过:死信可查/拒收即拉黑/冷查 16ms<1s)**——D1/D2=C1 回调推送引擎+ C2 上行自动拉黑(真机六步实证,验收单 s4-d1d2-callback.md);D3=明细按天 RANGE(id) 分区热 5 天(迁移 v22,9 分区)+CH 冷热归档 job(count 校验零丢失方向)+/record/history 冷查(settle-check 热窗感知 DetailPartial 两方基线;真机 5 连坑全修存档,验收单 s4-d3-partition-archive.md)。 - **下一步=S5 基线与灰度(8 日,一期最后泳道)**:kind 安装+deploy/k8s manifests apply(NodePort 30081)→ 24h 稳定性复核(S4 动了大表结构,S5 压测前重跑一轮而非沿用 11-14 旧判)→ 压测基线 200QPS×30min(SSD 下重标 workers:4/55/s 等 HDD 数字)→ 消费参数重标定 → 灰度接管现网流量。**出口四项**:七件套全绿/P0+P1+结算覆盖矩阵全勾/SSD 基线报告入档/v2 承载 ≥1 周零 P0 事故+POC 转冷备。