ThinkPHP复合主键怎么建_ThinkPHP联合主键设计说明【汇总】-ThinkPHP-PHP中文网

thinkphp实现复合主键需同时满足三条件：建表时主键字段显式声明not null、迁移中禁用默认id并指定primary_key数组、模型中$pk为顺序一致的字符串数组；否则查询、更新、验证均会失效。

thinkphp复合主键怎么建_thinkphp联合主键设计说明【汇总】

ThinkPHP 本身不“建”复合主键，它只是把你的定义转成 SQL 交给数据库执行。关键在 PRIMARY KEY 声明是否合法、字段是否满足约束、模型层是否能正确识别——三者缺一不可。

MySQL 要求复合主键所有字段都为 NOT NULL，否则会静默忽略该约束或建表失败。ThinkPHP 迁移工具不会自动帮你补这个约束。

错误写法：CREATE TABLE user_role (user_id INT, role_id INT, PRIMARY KEY (user_id, role_id)) → 两个字段没加 NOT NULL，主键可能失效
正确写法：CREATE TABLE user_role (user_id INT NOT NULL, role_id INT NOT NULL, PRIMARY KEY (user_id, role_id))
用 ThinkPHP 迁移时，addColumn('user_id', 'integer') 默认不带 NOT NULL，得手动加：->addColumn('user_id', 'integer', ['null' => false])

ThinkPHP 迁移默认会加 id 自增字段，一旦你要用复合主键，就得关掉它，并显式指定主键字段。

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

下载

关掉默认 id：$this->table('user_role', ['id' => false, 'primary_key' => ['user_id', 'role_id']])
字段类型要匹配：如果数据库里 user_id 是 BIGINT UNSIGNED，迁移里只写 'integer' 可能导致类型不一致，建议用 'biginteger' 并加 ['unsigned' => true]
别漏掉时间字段的默认值：比如 created_at 要设 ['default' => 'CURRENT_TIMESTAMP']，否则插入时可能报错

ThinkPHP 模型靠 $pk 属性知道主键是什么。复合主键下它必须是字符串数组，且顺序要和数据库索引完全一致，否则 update、delete 会拼错 WHERE 条件。

正确写法：protected $pk = ['user_id', 'role_id'];
错误写法：protected $pk = 'user_id,role_id'; 或 protected $pk = ['role_id', 'user_id'];（顺序反了）
查询时必须传全：UserRole::where(['user_id' => 123, 'role_id' => 456])->find(); 缺一个字段，find() 就查不到
save() 更新也一样：只有 $model->user_id = 123; $model->role_id = 456; $model->save(); 才能定位到行；只改其中一个字段再 save，会变成 INSERT

ThinkPHP 的 unique 验证规则不支持多字段组合校验，直接写 ['unique' => ['user_role', 'user_id,role_id']] 看似能过，但底层查的是单字段，不是联合值。

真正安全的做法：先在数据库建联合唯一索引：ALTER TABLE `user_role` ADD UNIQUE INDEX `uniq_user_role` (`user_id`, `role_id`);
再用 Rule::callback 写验证逻辑，确保查的是组合：['user_id','role_id'] => Rule::callback(function($value, $rule, $data) { return $this->where($data)->count() === 0; })
注意并发：即使加了索引和 callback，高并发插入仍可能撞上唯一冲突，得捕获 IntegrityConstraintViolationException 并友好提示

最容易被忽略的是字段顺序——数据库索引顺序、迁移定义顺序、模型 $pk 顺序、验证时 where 条件顺序，四者必须严格一致，差一个就查不到、删不掉、验不准。