# 用户服务接口契约审计修复（mp 侧字段/契约对齐）— 修改接口 — 小程序

> 变更类型：字段/契约对齐（无破坏性删除），小程序侧影响较小
> 端类型：小程序（用户中心/首页配置/收藏足迹/出行人 OCR）
> 日期：2026-06-17
> 服务：hl-user-service
> PR：https://git.1814.love:8443/wx/HL/pulls/3924
> 说明：本文件随 user-service 契约审计一并产出，**暂缓推送**（与小程序侧统一节奏）。admin 侧见 changelogs-v2/2026-06/17_3924_*.md。

---

## 关键说明

用接口契约语义审计工作流扫描 hl-user-service 全部 Controller，mp（小程序 BFF）侧修复一批字段名/null 语义/响应结构与 Swagger 契约不符项。已合并 dev-v3、部署测试服、本地全量 2793 单测零新增回归。下面列 mp 侧对接相关变更。

---

## 1. 收藏 / 足迹（FavoriteRespVO / FootprintRespVO）

- 响应 VO 字段名/缺字段与契约对齐；金额类字段（如有）补 `@JsonSerialize(ToStringSerializer)` 输出字符串。
- 字段语义不变，前端按现有字段名接收即可；如此前对金额字段做数字运算，改为先转数值。

## 2. 首页配置（MpHomeConfig / MpHomeScreen2VO）

- 响应结构与 Swagger 契约对齐（字段名/层级稳定化），无破坏性删除。

## 3. 出行人 OCR / 内容安全（MpTravelerOcr / MpContentSecurity）

- 入参校验（`@Valid` / 校验分组）与错误码规范化；正常路径返回结构不变。

## 4. 站内信（InternalMpMessage / 未读数 UnreadCountRespVO）

- 未读数等响应改强类型 VO，字段名不变。

---

> 待小程序侧统一接线时一并对照本文件；如需提前对接某一节请单独知会。
