hl-api-changelog/changelogs-v2/2026-08/05_5536_保险订单v3补orders列表别名-新增接口-管理后台.md

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

schema	ticket	title	consumer	change_type	author	backend_status	gateway_status	frontend_status	frontend_owner	frontend_ref	target_release	verified_at	status_note	updated_at	base
hl-changelog/v2	5536	保险订单 v3 补 /orders 列表别名（对齐 v2 与前端调用）	admin	新增接口	wx(GIT)	deployed	verified	pending	wx	hl-ui 保险订单页已调 /v3/admin/insurance/orders（此前 404），后端别名已上线，无需前端改动；待前端回归确认页面加载恢复后置 verified			后端完成：PR #5541 已合并 dev-v3 并部署 TEST；网关实测 /v3/admin/insurance/orders 200 total=255，与 /list 完全一致（修复前 404）。前端保险订单页无需改动，回归确认后置 verified。	2026-08-05	dev-v3

保险订单 v3 补 /orders 列表别名（#5536）

服务: hl-order-service-v3 PR: #5541 Issue: #5536（P1） 联系人: @wx 日期: 2026-08-05 影响范围: 管理后台-保险管理-保险订单页（前端已调 /orders 复数路径）

---

背景

前端保险订单页调 GET /v3/admin/insurance/orders → 404 数据加载失败。v3 只有 /v3/admin/insurance/list（实测 code=200 total=255），缺 /orders 复数别名；v2（/admin/insurance/orders）与前端调用均为复数路径。

变更接口

方法	路径	来源
GET	/v3/admin/insurance/orders	管理后台-保险订单页

变更说明

AdminInsuranceController.listOrders 路由映射由 "/list" 扩展为 /list 与 /orders 两个路径——同一方法同返回（分页参数 InsuranceQueryRequest 与 /list 完全一致），不新增逻辑。

接口行为变化

接口	修复前	修复后
GET /v3/admin/insurance/orders	404	200，PageResult<InsuranceOrderVO>（total=255，与 /list 一致）
GET /v3/admin/insurance/list	200	不变

验证证据

• 网关实测（api.test.1814.love:9443，admin，2026-08-05）：/v3/admin/insurance/orders 200 total=255；/v3/admin/insurance/list 200 total=255；首条 insuranceOrderId=2084823362831306753 / extPolicyNo=MOCKPOL-... / totalPremium="88.00"，两路径响应一致
• 定向测试：AdminInsuranceControllerTest 19/19（新增 /orders 别名与 /list 同返回断言用例）