Skip to content

2026-10-07-01 chat 用户完整信息搜索安全收敛 ​

1. 变更摘要 ​

本次针对 chat 用户完整信息搜索接口进行安全收敛:

  • 变更接口:/user/search/full
  • 禁止空关键字搜索:keyword 去空白后不可为空
  • 分页上限收敛:pagination.showNumber 最大为 50
  • 普通用户能力收敛:仅允许精确匹配(userID/account/phoneNumber/email/nickname)
  • 普通用户隐私保护:响应中的 phoneNumber 返回脱敏值

2. 前端影响与动作 ​

  • 若当前使用模糊关键字(如昵称片段)调用该接口且调用方是普通用户,需要改为精确值查询。
  • 若当前 showNumber 大于 50,需要调整分页大小。
  • 若前端对手机号展示依赖明文,需要改为兼容脱敏显示。

动作等级:必须改

3. 接口变更清单 ​

3.1 修改接口 ​

说明路径状态链接
用户完整信息搜索安全收敛/user/search/fullCompatible跳转

3.2 新增接口 ​

无

3.3 删除接口 ​

无

4. 兼容性说明 ​

  • 接口路径与响应结构未变,属于行为收敛。
  • 普通用户查询行为从“可模糊”收敛为“仅精确匹配”。
  • 普通用户响应手机号从明文收敛为脱敏值。
  • 管理员调用保持既有搜索能力。

5. 前端对接步骤(最简) ​

  1. 确保请求体 keyword 非空且去空白后仍有内容。
  2. 将 pagination.showNumber 调整到 1-50。
  3. 普通用户场景下改为传精确关键字查询。
  4. 前端手机号展示适配脱敏返回值。