hl-api-changelog/changelogs-v2/2026-08/15_5928_司机险保单分页新主链POST-修改接口-管理后台.md

schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base, generated

schema	ticket	title	consumer	author	change_type	backend_status	gateway_status	frontend_status	frontend_owner	frontend_ref	target_release	verified_at	status_note	updated_at	base	generated
hl-changelog/v2	5928	车务司机险保单分页新主链改 POST JSON body + 新路径 GET 显式 405	admin	wx	修改接口	deployed	verified	verified	mmg	5931e3ef		2026-08-16	后端完成：PR #5977 已合并 dev-v3（a006b2b46）并部署 TEST（hl-fleet-service 双实例 UP）。网关实测：POST 新主链 code=200 返回分页；GET 新路径 405；旧 GET /policies 兼容 code=200；新旧 coverage 字段混传 code=100001。	2026-08-16	dev-v3	2026-08-15T21:30:00+08:00

车务司机险保单分页新主链改 POST JSON body + 新路径 GET 显式 405（#5928）

背景

司机险保单分页主链含预筛集合（最多 1000 个雪花 ID），GET query 会撑爆 URL，故主链强制 POST JSON body。本次对齐契约：新主链路径改 POST，GET 显式拒绝；旧路径保留 deprecated 兼容。

变更接口

接口	变更
POST /admin/fleet/insurance/driver-policies/page	新主链，@RequestBody JSON；只收新字段 coverageStartDate/coverageEndDate；预筛 ID 集合走 body
GET /admin/fleet/insurance/driver-policies/page	显式 405 Method Not Allowed（防 /driver-policies/{insuranceOrderId} 模板把 page 当保单 ID 吞掉）；Swagger 隐藏
GET /admin/fleet/insurance/policies	保留 deprecated 兼容别名，仅收旧标量参数 coverageStartDateFrom/coverageStartDateTo

行为变化

• 新旧 coverage 字段不可混传：新路径传 coverageStartDateFrom/coverageStartDateTo 或与 coverageStartDate/coverageEndDate 混传，返回 100001（参数非法），message 明确提示「仅旧路径 /policies 使用」。
• 新路径不再支持 GET；前端保单 Tab 请改用 POST + JSON body。

前端动作

• 保单分页改调 POST /admin/fleet/insurance/driver-policies/page，参数放 JSON body。
• 使用新字段名 coverageStartDate/coverageEndDate；不要再对新路径传 coverageStartDateFrom/To。
• 旧 GET /policies 仅为兼容保留，新代码请迁移到新主链。

验证证据

• FleetInsuranceTaskControllerTest 17 + FleetRedLineArchTest 13 = 30 全绿，spotless 通过。
• 网关（TEST, 真 SUPER_ADMIN token）实测：POST 新主链 code=200 返回 46 条分页；GET 新路径 405；旧 GET /policies code=200；新旧 coverage 混传 code=100001。