ThinkPHP模型联合字段唯一验证需用unique规则显式指定表名和逗号分隔的字段串，字段顺序须与数据库联合索引一致，更新时需传主键或用第四参数排除，且须手动配置msg提示具体冲突字段。
ThinkPHP 模型里怎么加联合字段唯一验证
直接用 unique 验证规则不行——它默认只校验单字段，联合唯一必须显式指定字段组合。ThinkPHP 6 的 Validate 类支持传数组定义多字段，但模型层调用时容易漏掉表名或忽略数据库字段大小写差异。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在模型的
validate属性或validateScene方法中，用['unique' => ['user', 'username,phone']]格式：第一个参数是表名（非模型名），第二个是逗号分隔的字段名字符串 - 字段顺序必须和数据库索引顺序一致，否则 MySQL 可能不命中联合索引，验证通过但实际插入失败
- 如果表用了前缀（如
tp_user），unique规则里的表名也得带前缀，否则查不到数据 - 注意空字符串和
NULL的行为：MySQL 中UNIQUE索引允许多个NULL，但 ThinkPHP 的unique验证会把NULL当普通值处理，导致误判
验证失败时提示“该记录已存在”但没说明哪几个字段冲突
默认错误信息太笼统，用户不知道是 username 冲突还是 username+email 联合冲突。这是因为 unique 规则没配自定义 message，且 ThinkPHP 不自动展开多字段名。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 手动写 message，比如：
['unique' => ['user', 'username,email'], 'msg' => '用户名和邮箱组合已被占用'] - 如果同一模型有多个联合唯一规则，建议用场景（scene）隔离，避免规则互相覆盖：
$this->validate($data, 'User.validate_email_bind', [], [], 'update') - 别依赖
appendRule动态追加，模型验证规则在实例化时就编译完成，运行时追加无效
更新数据时联合唯一验证绕过了当前记录自身
编辑用户时，改了其他字段但没动 username 和 email，验证仍报“已存在”——这是没传主键 ID 给验证器，导致它查出自己也算作重复。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 更新场景下，必须在验证数据里带上主键，例如：
['id' => 123, 'username' => 'a', 'email' => 'b@x.com']，然后规则写成['unique' => ['user', 'username,email,id']]（末尾加主键字段名） - ThinkPHP 6.1+ 支持第四参数指定排除 ID：
['unique' => ['user', 'username,email', 'id', 123]]，但要注意第三个参数是字段名，第四个才是值 - 如果主键不是
id（比如叫user_id），规则里字段列表和排除参数都得同步改，否则失效
MySQL 建联合唯一索引时字段顺序影响验证结果
验证器能过，但插入时报 Duplicate entry ——大概率是数据库索引字段顺序和验证规则不一致。比如索引是 (email, username)，但验证规则写了 username,email，验证器生成的 SQL 用的是后者顺序，可能走不到索引。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先用
SHOW INDEX FROM `user`确认索引字段顺序，验证规则严格对齐 - 联合索引最左前缀原则下，
(a,b)能加速WHERE a=? AND b=?，但不能加速WHERE b=?；验证器内部 SQL 是等值查询，所以字段顺序错会导致全表扫描甚至验证逻辑偏差 - 开发环境开
DB_DEBUG = true，看验证器生成的 SQL 是否命中key_name，没命中就立刻检查顺序
联合唯一不是把字段堆一起就行，表结构、验证规则、更新逻辑三者字段顺序和主键处理必须咬死。漏一个，线上就可能卡在“明明没重复却报错”或者“报错但实际插进去了”这种边界问题上。
