74 行
2.7 KiB
Markdown
74 行
2.7 KiB
Markdown
# MP 订单详情 travelers[] 字段 travelerId 从 null 变真实值
|
|
|
|
**日期**: 2026-04-22
|
|
**PR**: #1208
|
|
**Issue**: #1207
|
|
**服务**: hl-order-service-v2(已部署测试服 双实例 8094/8194)
|
|
**影响端**: 小程序订单详情页、管理端可能调用的 MP 订单详情
|
|
|
|
## 问题
|
|
|
|
`GET /mp/order/{orderId}` 返回的 `data.travelers[]` 数组,每条出行人对象的:
|
|
|
|
- `travelerId` —— **之前永远是 null**
|
|
- `travelerTypeLabel` —— 之前永远是 null
|
|
- `idCardTypeLabel` —— 之前永远是 null
|
|
|
|
前端凡是依赖 `travelerId` 做**编辑 / 删除 / 关联**的操作都不可用;依赖 label 做展示的会显示空。
|
|
|
|
## 根因(后端自修)
|
|
|
|
后端 `MpOrderDetailAssembler` 用 Hutool `BeanUtil.toBean` 做 `OrderTraveler → TravelerVO` 映射,但 Entity 主键字段名 `orderTravelerId` ≠ VO 字段 `travelerId`,属性精确匹配不上导致 id 永久 null;enum 类型字段转 label 也被吞。修复后复用同 Service 已有的正确手动映射方法。
|
|
|
|
## 字段契约(修复后)
|
|
|
|
```
|
|
GET /mp/order/{orderId}
|
|
Response.data.travelers: Array<MpTravelerVO>
|
|
```
|
|
|
|
每条 MpTravelerVO 关键字段:
|
|
|
|
| 字段 | 类型 | 修复前 | 修复后 |
|
|
|------|------|--------|--------|
|
|
| `travelerId` | Long | null | 真实雪花 ID |
|
|
| `name` | String | 正常 | 正常 |
|
|
| `travelerType` | String | 正常(ADULT/CHILD/YOUNG_CHILD/BABY) | 正常 |
|
|
| `travelerTypeLabel` | String | null | "成人"/"儿童"/"幼儿"/"婴儿" |
|
|
| `idCardType` | String | 正常(IDCARD/PASSPORT/...) | 正常 |
|
|
| `idCardTypeLabel` | String | null | "身份证"/"护照"/... |
|
|
| `idCardNo` | String | 正常 | 正常 |
|
|
| `phone` / `gender` / `birthday` / ... | | 正常 | 正常 |
|
|
|
|
## 前端 TODO(若此前有兜底)
|
|
|
|
- 如果之前判空后显示"-"或不显示编辑/删除按钮,现在可以直接信任 `travelerId` 非 null
|
|
- 如果之前手动拼 label,现在可以直接用 `travelerTypeLabel` / `idCardTypeLabel`
|
|
- 无需改任何请求签名,无需发版,后端部署后次日生效(前端刷新页面即生效)
|
|
|
|
## 验证
|
|
|
|
```bash
|
|
# 测试服内部 curl(需 gateway token)
|
|
curl "https://api.test.1814.love:9443/mp/order/{orderId}" -H "Authorization: Bearer {TOKEN}"
|
|
|
|
# 断言
|
|
.data.travelers[].travelerId != null
|
|
.data.travelers[].travelerTypeLabel in ["成人","儿童","幼儿","婴儿"]
|
|
```
|
|
|
|
实测订单 `2046842978273579010`:
|
|
```json
|
|
{
|
|
"travelers": [
|
|
{ "travelerId": 2046911429360955393, "name": "米明光", "travelerType": "ADULT", "travelerTypeLabel": "成人" },
|
|
{ "travelerId": 2046911429365149698, "name": "王晓", "travelerType": "YOUNG_CHILD", "travelerTypeLabel": "幼儿" }
|
|
]
|
|
}
|
|
```
|
|
|
|
## 无破坏性
|
|
|
|
- 字段名/类型不变,仅值从 null 变真实值
|
|
- 无前端代码必须改动
|