# 【小程序】常见问题 /mp/common/faq 返回结构修正为 {id, name, items:[{id, question, answer}]}

> **类型**: 后端出参结构修复(fix,后端已改并部署测试服验证通过)
> **服务**: hl-mp-service
> **日期**: 2026-05-29
> **影响范围**: 小程序端 `GET /mp/common/faq` 返回体结构
> **归属**: 后端已修(PR #3237 → dev,#3238 同步 dev-v3;修正了早先 #3231/#3232 的错误修法)
> **状态**: 已部署测试服并验证通过
> **关联工单**: #3230

---

## ⚠️ 更正说明

本文件早先版本(基于 PR #3231)写的「对外字段名仍是 `category`、结构不变」是**错误的**。前端实际期望的是 `{id, name, items:[{id, question, answer}]}`(分类名读 `name` 不是 `category`,且需要分类 `id` 和 item `id`)。已用 PR #3237 修正,以本文为准。

## 一、最终返回结构

```json
{
  "code": 200,
  "data": [
    {
      "id": 1,
      "name": "产品怎么选",
      "items": [
        { "id": 10, "question": "……", "answer": "……" }
      ]
    }
  ]
}
```

- 分组:`id`(分类ID)、`name`(分类名)、`items`
- 条目:`id`(问题ID)、`question`、`answer`
- 与前端现有读取方式(`cat.id` / `cat.name` / `item.id` / `item.question` / `item.answer`)一致,**前端无需改动**。

## 二、背景

之前 mp 返回的是 `{category, items:[{question, answer}]}` —— 分类名字段名错(`category` 而非 `name`)、且缺分类 `id` 与 item `id`,与前端不符。现已改为上游 user-service 原始结构,字段按名直通。

## 三、测试服实测

清缓存后 `GET /mp/common/faq` 返回 4 个分组,分组 keys = `[id, name, items]`(无 `category`),item keys = `[id, question, answer]`,与前端结构完全一致。
