From 47974f24ae3de1e8909810317bc5a11883c062d8 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Fri, 29 May 2026 09:23:10 +0800 Subject: [PATCH] =?UTF-8?q?fix(mp):=20/mp/common/faq=20=E5=88=86=E7=B1=BB?= =?UTF-8?q?=E5=90=8D=20category=20=E8=A1=A5=E5=9B=9E=20changelog=20(#3231,?= =?UTF-8?q?=20=E5=B7=A5=E5=8D=95=20#3230)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../29_fix_mp_common_faq_category_null.md | 28 +++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 changelogs/2026-05/29_fix_mp_common_faq_category_null.md diff --git a/changelogs/2026-05/29_fix_mp_common_faq_category_null.md b/changelogs/2026-05/29_fix_mp_common_faq_category_null.md new file mode 100644 index 0000000..7bb9854 --- /dev/null +++ b/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` 正常。