---
schema: "hl-changelog/v2"
ticket: "5407"
title: "景区列表移除 deinfo 返回参数"
consumer: "multiple"
change_type: "修改接口"
backend_status: "pending"
gateway_status: "pending"
frontend_status: "pending"
frontend_owner: ""
frontend_ref: ""
target_release: ""
verified_at: ""
status_note: "后端 PR #5408 已合并 xr；测试环境部署和网关验证尚未执行"
updated_at: "2026-08-01"
base: "xr"
---

# 景区管理：列表移除 deinfo 返回参数

> **服务**：hl-resource-service
> **PR**：#5408
> **Issue**：#5407
> **日期**：2026-08-01
> **影响范围**：管理后台景区管理列表；内部小程序景区列表共用响应 VO

## 一、撤销背景

工单 #5405 曾为景区列表增加固定返回 `文旅info` 的 `deinfo` 字段。本次按 #5407
撤销该契约扩展，列表响应不再包含 `deinfo`。其他字段、分页结构、查询条件和排序逻辑不变。

## 二、变更接口

| 接口 | 方法 | 路径 | 变更 |
|---|---|---|---|
| 景区管理查询列表 | GET | `/admin/scenic/spots` | 每条列表记录移除 `deinfo` |
| 内部小程序景区列表 | GET | `/internal/mp/scenic/list` | 共用 VO，不再序列化 `deinfo` |

移除后的响应示例：

```json
{
  "code": 200,
  "data": {
    "records": [
      {
        "scenicId": "1001",
        "name": "九寨沟"
      }
    ],
    "total": 1,
    "current": 1,
    "size": 20
  },
  "success": true
}
```

空列表仍沿用原分页结构，`records` 为 `[]`，不会生成占位记录。

## 三、兼容性与调用方事项

- 管理后台不得再读取或展示 `deinfo`。
- 内部小程序消费者以 `Map<String, Object>` 接收，当前实现未读取 `deinfo`，移除该键不影响既有映射。
- 请求参数、其余响应字段、分页、筛选和排序行为均不变化。
- 本文撤销 #5405 的新增字段说明，调用方应以本契约为准。

## 四、验证

- JSON 契约测试：2 项通过，确认普通记录不含 `deinfo`，空分页结构保持不变。
- `hl-resource-service` reactor：1712 项测试通过，0 失败；38 项为仓库既有跳过测试。
- `hl-mp-service` 景区聚合消费方：13 项测试通过，0 失败。
- oasdiff：`not_configured`，一期项目没有稳定 OAS3 导出与已配置工具，使用源码和 JSON 序列化测试回退。
- Spring Cloud Contract：`not_configured`，使用生产者及消费者 reactor 测试回退。
- 测试环境部署和网关验证尚未执行，因此 `backend_status`、`gateway_status` 保持 `pending`。

## 五、关联

- [本次工单 #5407](https://git.1814.love:8443/wx/HL/issues/5407)
- [本次后端 PR #5408](https://git.1814.love:8443/wx/HL/pulls/5408)
- [被撤销工单 #5405](https://git.1814.love:8443/wx/HL/issues/5405)
- [被撤销后端 PR #5406](https://git.1814.love:8443/wx/HL/pulls/5406)
