fix(mp): /mp/common/faq 分类名 category 补回 changelog (#3231, 工单 #3230)

changelogs/2026-05/29_fix_mp_common_faq_category_null.md

@@ -0,0 +1,28 @@
+# 【FYI·小程序】常见问题 /mp/common/faq 分类名 category 补回(前端无需改)
+
+> **类型**: 后端字段修复(fix,后端已改并部署测试服验证通过)
+> **服务**: hl-mp-service
+> **日期**: 2026-05-29
+> **影响范围**: 小程序端 `GET /mp/common/faq` 返回体每个分组的 `category`(分类名)字段
+> **归属**: 后端已修(PR #3231 → dev,#3232 同步 dev-v3)
+> **状态**: 已部署测试服并验证通过
+> **关联工单**: #3230
+
+---
+
+## 一、问题
+
+小程序 `GET /mp/common/faq` 返回的 FAQ 分组里,`category`(分类名)一直是 null/空;问题列表 `question`/`answer` 正常。
+
+根因(后端内部):上游 user-service 重构后分类名字段叫 `name`,而 hl-mp-service 反序列化用的字段叫 `category`,字段名错位映射不上 → `category` 恒空。
+
+## 二、改动(后端已完成)
+
+后端已修正字段映射。现在 `GET /mp/common/faq` 每个分组的 `category` 正常返回真实分类名。
+
+- **对外字段名不变**,仍是 `category`,前端按原样读取即可,**无需任何改动**。
+- 返回结构不变:`data: [ { category: "分类名", items: [ { question, answer } ] } ]`。
+
+## 三、测试服实测
+
+清缓存后 `GET /mp/common/faq` 返回 4 个分组,`category` 全部为真实分类名(常见问题 / 售后服务 / 行前准备 / 目的地信息),无一为空;`items` 的 `question`/`answer` 正常。