Skip to content

2026-10-13-01 adminx 用户搜索字段拆分 ​

1. 变更摘要 ​

调整 /adminx/user/search/full 的用户搜索参数:

  • keyword 为空时不增加关键字过滤;非空时按用户 ID、账号、手机号精确匹配,或按昵称、邮箱前缀匹配(忽略大小写),字段间按 OR 组合。
  • 新增 userID、phoneNumber、account、email 四个独立精确匹配字段。
  • 独立精确匹配字段及性别、normal 等其他筛选条件与 keyword 搜索按 AND 组合;不支持 areaCode 搜索。

2. 前端影响与动作 ​

下拉选择等单关键字搜索可继续使用 keyword。需要对指定字段做精确筛选时,使用独立的 userID、phoneNumber、account 或 email 参数。

动作等级:必须改

3. 接口变更清单 ​

说明路径状态链接
用户搜索参数语义调整/adminx/user/search/fullActive跳转

4. 兼容性说明 ​

  • keyword 支持在用户 ID、账号、手机号、昵称、邮箱五个字段中搜索;其中用户 ID、账号、手机号精确匹配,昵称和邮箱前缀匹配且忽略大小写。
  • 独立参数 userID、phoneNumber、account、email 均精确匹配,并与 keyword 命中条件按 AND 组合。
  • 支持空 keyword;不支持 areaCode 搜索。
  • 分页、排序、性别过滤、普通用户范围和响应结构保持不变。

5. 前后端动作 ​

  1. 通用单关键字搜索使用 keyword。
  2. 指定字段精确过滤时使用 userID、phoneNumber、account、email。
  3. 如需与 keyword 同时限定某一字段,同时传入对应独立参数。