From 0ab287215b6303b06ff743174319e237650992f4 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Tue, 16 Jun 2026 14:15:46 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog-v2):=20=E5=8F=B8=E6=9C=BA?= =?UTF-8?q?=E8=BD=AF=E5=88=A0=E8=81=94=E5=8A=A8=E4=BD=9C=E5=BA=9F=E7=BB=AD?= =?UTF-8?q?=E7=AD=BEtoken=20+=20=E5=89=8D=E7=AB=AF=E9=9C=80=E8=A1=A5?= =?UTF-8?q?=E6=A1=A3=E6=A1=88=E7=BC=BA=E5=A4=B1=E5=88=86=E6=94=AF=20(#3867?= =?UTF-8?q?/PR#3868)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...67_续签司机软删联动作废token-前端需配合.md | 31 +++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 changelogs-v2/2026-06/16_3867_续签司机软删联动作废token-前端需配合.md diff --git a/changelogs-v2/2026-06/16_3867_续签司机软删联动作废token-前端需配合.md b/changelogs-v2/2026-06/16_3867_续签司机软删联动作废token-前端需配合.md new file mode 100644 index 0000000..e65b1d6 --- /dev/null +++ b/changelogs-v2/2026-06/16_3867_续签司机软删联动作废token-前端需配合.md @@ -0,0 +1,31 @@ +# 【后端·需前端配合】司机软删联动作废其未消费续签 token + 续签「核对档案」需补「查不到档案」分支（PR #3868 / 工单 #3867） + +> 端：后端行为修复 + **前端需配合**（H5 续签核对档案步）| 服务：hl-fleet-service | PR #3868 已合并 dev-v3 + 部署实测 | 2026-06-16 + +## ⚠️ 关键说明 + +修复「续签时查不到上赛季档案，却仍能进入下一步」。根因：续签 token 的目标司机被**软删**后，H5 init 的 `getRenewPrefill` 返 null（prefill 为空），但 token 仍 `tokenValid=true`、无任何「档案缺失」信号。 + +## 后端已做（行为变更） + +司机被软删时（`DriverService.delete`），h5 域新增监听器联动**作废该司机所有未消费的续签 token**（mode=renew 且非 approved 非 voided）。作废后： + +- H5 `init` 对该 token 返回 `tokenState=voided` +- H5 提交/校验（`validateToken`）抛 `LINK_VOIDED`（码 600304） + +即：目标司机档案没了，续签链接自动失效。 + +## 前端需配合（mmg） + +1. **现有失效处理已可兜底**：续签 token 被作废后 init 返 `tokenState=voided`，前端**现有的失效链接处理**会直接拦住「下一步」——这部分**无需新增代码**，只要确认续签流程也走 tokenState 失效判断即可。 +2. **建议补「未查询到档案」友好分支**（可选增强）：续签「核对档案」步当前写死「档案已由系统从上赛季自动同步」。建议增加判断——当 init 返回的续签预填 `prefill` 为空/缺失时，不显示「已同步」，改提示「未查询到您的档案，请联系车管重新生成链接」并禁用「下一步」，比通用「链接失效」更友好。 + +> 注：原型 `page_pending_h5.jsx` 续签「核对档案」步目前只有「已同步」单一状态，请一并在原型与真实 H5 补「档案缺失」分支。 + +## 验证（测试服 2026-06-16） + +``` +fleet 双实例 8087/8187 全新重启，Started 干净无 APPLICATION FAILED +27 单测全绿（作废/空操作/幂等/WrapperX 条件/监听器吞异常）；CR CLEAN +域解耦：h5 监听器只操作 fleet_driver_pending，不碰 driver Mapper +```