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/full | Compatible | 跳转 |
3.2 新增接口
无
3.3 删除接口
无
4. 兼容性说明
- 接口路径与响应结构未变,属于行为收敛。
- 普通用户查询行为从“可模糊”收敛为“仅精确匹配”。
- 普通用户响应手机号从明文收敛为脱敏值。
- 管理员调用保持既有搜索能力。
5. 前端对接步骤(最简)
- 确保请求体
keyword非空且去空白后仍有内容。 - 将
pagination.showNumber调整到1-50。 - 普通用户场景下改为传精确关键字查询。
- 前端手机号展示适配脱敏返回值。