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/full | Active | 跳转 |
4. 兼容性说明
keyword支持在用户 ID、账号、手机号、昵称、邮箱五个字段中搜索;其中用户 ID、账号、手机号精确匹配,昵称和邮箱前缀匹配且忽略大小写。- 独立参数
userID、phoneNumber、account、email均精确匹配,并与 keyword 命中条件按 AND 组合。 - 支持空 keyword;不支持
areaCode搜索。 - 分页、排序、性别过滤、普通用户范围和响应结构保持不变。
5. 前后端动作
- 通用单关键字搜索使用
keyword。 - 指定字段精确过滤时使用
userID、phoneNumber、account、email。 - 如需与 keyword 同时限定某一字段,同时传入对应独立参数。