Laravel Eloquent upsert报唯一约束冲突，如何支持复合唯一键？

1. 确认Laravel版本 #

Laravel在8.37.0版本才正式支持复合唯一键作为upsert的冲突检测条件，若使用的版本低于此，需升级Laravel版本——旧版本无法正确识别复合唯一约束，会直接触发重复插入错误。

2. 检查待插入数据本身 #

确保$personsData数组内不存在重复的ID+LastName组合。upsert的逻辑是先尝试批量插入，遇到唯一约束冲突时才执行更新；如果待插入数据内部就有重复的复合键组合，插入阶段就会触发1062错误，与upsert逻辑无关。

比如以下数据会直接报错：

$personsData = [
    ['ID' => 1, 'LastName' => 'Smith', 'FirstName' => 'John', 'Age' => 30],
    ['ID' => 1, 'LastName' => 'Smith', 'FirstName' => 'Jane', 'Age' => 28], // 重复的ID+LastName组合
];

需先对$personsData做去重处理，保留需要的目标数据。

3. 验证数据库复合唯一约束 #

执行以下SQL语句，确认UC_Person约束是否正确生效：

SHOW CREATE TABLE Persons;

查看输出结果中是否包含CONSTRAINT UC_Person UNIQUE (ID,LastName)，若约束不存在，需重新创建。

4. 确认upsert参数正确性 #

你的代码写法本身是符合要求的：

return $this->persons->upsert($personsData, ['ID', 'LastName'], $fieldsToUpdate);

第二个参数['ID', 'LastName']正是复合唯一键的列名数组，只要Laravel版本达标，该写法完全支持复合唯一键的upsert操作。

额外排查点 #

若以上步骤均无问题，可检查MariaDB的SQL模式：

SELECT @@sql_mode;

若包含STRICT_TRANS_TABLES等严格模式，一般不影响，但如果确认是模式导致约束检测异常，可尝试调整（非必要不建议随意修改）。

内容的提问来源于stack exchange，提问作者volnistii11