# 出行人性别字段类型变更：Integer → String（匹配字典）

> 日期：2026-03-24
> 影响范围：小程序出行人模块、订单出行人模块
> 关联字典：`gender`

## 变更说明

出行人相关接口的 `gender` 字段从 `Integer` 改为 `String`，与字典 `gender` 的 `dict_value` 保持一致。

**之前**：`gender` 返回 Integer（如 `1`），前端用字典匹配时类型不一致导致报错
**现在**：`gender` 返回 String（如 `"1"`），可直接与字典 `dict_value` 匹配

## 字典值对照

| dict_value (String) | dict_label | 说明 |
|---------------------|------------|------|
| `"1"` | 男 | — |
| `"2"` | 女 | — |

## 受影响接口

### 小程序 - 出行人接口

| 接口 | 方法 | 路径 |
|------|------|------|
| 添加出行人 | POST | `/mp/user/traveler` |
| 出行人列表 | GET | `/mp/user/traveler` |
| 出行人详情 | GET | `/mp/user/traveler/{id}` |
| 更新出行人 | PUT | `/mp/user/traveler/{id}` |

**请求参数变更**：
```json
{
  "gender": "1"    // 之前是 Integer 1，现在是 String "1"
}
```

**响应字段变更**：
```json
{
  "gender": "1"    // 之前是 Integer 1，现在是 String "1"
}
```

### 订单 - 创建订单（出行人信息）

| 接口 | 方法 | 路径 |
|------|------|------|
| 创建订单 | POST | `/mp/order` |

**travelers 数组中的 gender 字段**：
```json
{
  "travelers": [
    {
      "name": "张三",
      "gender": "1",    // String，不再是 Integer
      "idCardType": "ID_CARD",
      "idCardNo": "110101199001011234"
    }
  ]
}
```

## 前端适配要点

1. **提交时**：`gender` 传 String 类型（`"1"` 或 `"2"`），不要传 Integer
2. **展示时**：返回值已经是 String，可直接用字典 `dict_value` 匹配显示中文标签
3. **编辑回显**：`gender` 是 String，选择器绑定值直接用即可，无需类型转换