ThinkPHP如何自定义验证器多字段_ThinkPHP联合唯一校验教程【教程】-ThinkPHP-PHP中文网

thinkphp 的 unique 规则不支持字符串形式的联合字段（如 'email,username'），必须用数组格式显式指定表名、字段串、排除字段及值，且字段顺序、表名前缀、null 处理、id 类型和数据库索引必须严格对齐，否则验证失效或误判。

thinkphp如何自定义验证器多字段_thinkphp联合唯一校验教程【教程】

ThinkPHP 的 unique 规则不支持联合字段直接写成 'email,username' 字符串——它会报错或静默失效。必须用数组格式显式传表名、字段列表，且字段顺序、NULL 处理、ID 排除都得手动对齐数据库索引。

常见错误是写成 'email' => 'unique:users,email,username' 或 'email' => ['unique' => 'users,email,username']，这在 TP6/TP8 都不合法，验证器会跳过或抛异常。

正确写法（TP6）：['unique' => ['users', 'email,username']] —— 第一个元素是**真实表名**（含前缀，如 tp_users），第二个是逗号分隔的字段名字符串
字段顺序必须和数据库联合索引定义顺序完全一致，比如索引是 UNIQUE KEY uk_email_dept (email, dept_id)，那规则里就得写 'email,dept_id'，反过来就查不到
如果表名带前缀（如配置了 prefix => 'tp_'），unique 规则里的表名也得写 'tp_users'，否则 SQL 查的是 users 表，永远返回 0 条

编辑用户时，哪怕只改了昵称，unique 仍会把当前记录自己当“重复项”拦下来——因为验证器默认不认你是更新还是新增。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

TP6 写法：['unique' => ['users', 'email,dept_id', 'id', $this->id]]，其中第三个参数是排除字段名（默认 id），第四个是值；若主键叫 user_id，就得写成 ['unique' => ['users', 'email,dept_id', 'user_id', $this->user_id]]
TP8 更推荐键值对写法：['unique' => 'users,email,dept_id,id^' . $id]，注意 ^ 是分隔符，不是运算符
ID 值必须是整型或字符串型，和数据库字段类型一致；从 POST 拿的 $_POST['id'] 是字符串，但 MySQL INT 字段对比时可能隐式转换失败，建议先 (int) $id 强转

MySQL 的 UNIQUE 索引对 NULL 特殊处理：(1, NULL) 和 (1, NULL) 不算重复；但 ThinkPHP 的 unique 验证会把 NULL 当普通值查，导致误判“已存在”。

如果业务允许某字段为空，又依赖联合唯一，要么数据库字段设为 NOT NULL DEFAULT ''，要么在验证前统一转空字符串：$data['dept_id'] = $data['dept_id'] ?? ''
验证规则里别依赖 NULL 做条件分支，where 查询时 NULL 需用 IS NULL，而 unique 底层用的是 =，根本查不到
导入 Excel 场景更危险：数字列读出来可能是字符串 "123"，而库里存的是整型 123，联合查重时 MySQL 类型隐式转换可能失败，建议入库前统一 intval() 或 trim()

当需要「同一部门下邮箱唯一」+「排除当前 ID」+「delete_time = 0」软删除过滤时，unique 规则根本写不完，硬塞只会让逻辑散落在配置里，难调试易出错。

直接写 callback：'email' => ['callback' => function($value) use ($dept_id, $id) { return Db::name('users')->where('email', $value)->where('dept_id', $dept_id)->where('delete_time', 0)->where('id', '', $id)->count() === 0; }]
注意 where('id', '', $id) 要写全比较符，where('id', '', $id) 是旧写法，TP8 已不推荐
如果涉及多字段组合去重（如导入时校验 user_id + sku_id 是否已存在），别每行都查一次，先用 Db::name()->where('concat(user_id,"_",sku_id)', 'in', $keys)->column(...) 批量查，再比对

真正容易被忽略的不是怎么写规则，而是数据库索引是否生效、NULL 怎么存、ID 从哪来、字段大小写是否一致——这些点任何一个没对齐，验证就变成假阳性或假阴性。