hl-api-changelog/changelogs-v2/2026-08/13_5932_车务降级与权限错误码统一-修改接口-管理后台.md
Mimingguang 17bc59e6d8
一些检查失败了
changelog-filename-gate / validate (push) Failing after 2s
docs(changelogs-v2): #5937/#5933 verified,#5929/#5932/#5927 not_required
2026-08-13 09:32:09 +08:00

1.8 KiB

schema, ticket, title, consumer, change_type, author, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, updated_at, status_note, base
schema ticket title consumer change_type author backend_status gateway_status frontend_status frontend_owner frontend_ref target_release verified_at updated_at status_note base
hl-changelog/v2 5932 车务降级与权限错误码统一 admin 修改接口 wx(GIT) deployed verified not_required mmg not_required v2.1 2026-08-13 2026-08-13 PR #5950 已合并 dev-v3,fleet 测试服部署任务 30cb1e1b 成功;车辆分页和对账期分页网关只读实测 HTTP/code 200。 dev-v3

车务降级与权限错误码统一(#5932

变更接口

  • 本次不新增路径;统一 fleet 既有 Feign 降级、角色门禁及参数异常响应。
  • 受影响的管理端入口包括车辆分页与对账期分页等所有经过车务权限门禁的接口。

影响范围

  • fleet 调权限、文件、团期资源、订单服务的 Feign 降级响应统一为可稳定识别的六位业务码。
  • 日快照回调区分瞬时失败 605711 与永久 4xx 605712:前者重试,后者立即隔离。
  • 未认证/无权限分别保留真实 HTTP 401/403;超级管理员业务权限拒绝仍为 HTTP 200 + 业务码 403001
  • 参数绑定错误统一 HTTP 200 + 100001,类型错误文案补字段和日期格式提示。

前端适配

  • Feign 服务不可用按响应 code 处理,不依赖中文 message。
  • HTTP 401/403 继续由登录/权限公共处理器接管。
  • 403001 是业务权限码,不等于 HTTP 403。

验证证据

  • PR #5950,squash merge 453540c7
  • 聚焦 75/75,ArchTest 13/13,spotless 通过。
  • MockMvc 真实验证 HTTP 401/403。
  • Deploy Panel 30cb1e1b 成功。
  • 网关只读:GET /admin/fleet/vehicles/pageGET /admin/fleet/reconciliation/periods 均 HTTP 200 / code 200。