---
schema: "hl-changelog/v2"
ticket: "5536"
title: "保险订单 v3 补 /orders 列表别名（对齐 v2 与前端调用）"
consumer: "admin"
change_type: "新增接口"
author: "wx(GIT)"
backend_status: "deployed"
gateway_status: "verified"
frontend_status: "verified"
frontend_owner: "pi-main-session"
frontend_ref: "hl-admin@ef497e8e30d2df2d55d97f5554c8c5e921dc49ef"
target_release: ""
verified_at: "2026-08-05"
status_note: "后端完成：PR #5541 已合并 dev-v3 并部署 TEST；网关实测 /v3/admin/insurance/orders 200 total=255，与 /list 完全一致（修复前 404）。前端保险订单页无需改动，回归确认后置 verified。"
updated_at: "2026-08-05"
base: "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` 同返回断言用例）

## 关联/联系人

### 链接

- [后端工单 #5536](https://git.1814.love:8443/wx/HL/issues/5536)
- [后端 PR #5541](https://git.1814.love:8443/wx/HL/pulls/5541)
- Merge commit: `2936d67f1b`

### 联系人

- **后端负责人**: @wx
