# 【后端·需前端配合】司机软删联动作废其未消费续签 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
```
