Laravel测试环境SQLite执行upsert报ON CONFLICT约束不匹配错误

API 探路者

2026-10-6

问题原因

这个错误是SQLite和MySQL对upsert逻辑的校验规则差异导致的：

你调用Permission::upsert()时指定了冲突字段为name，SQLite要求该字段必须在数据表上显式定义PRIMARY KEY或UNIQUE约束，否则就会抛出ON CONFLICT clause does not match any PRIMARY KEY or UNIQUE constraint错误
MySQL对upsert（底层用ON DUPLICATE KEY UPDATE实现）的校验相对宽松，只要字段存在唯一索引就能正常运行，你本地MySQL环境的permissions表name字段已经有唯一约束，所以不会报错。

解决方案

按优先级选择以下方案即可：

方案1：给permissions表name字段添加唯一约束（推荐）

找到permissions表对应的迁移文件，在name字段的定义后加上->unique()，示例代码如下：

// 你的迁移文件中修改name字段定义
$table->string('name')->unique();

修改完成后重新执行测试环境迁移命令即可：

php artisan migrate:fresh --seed --env=testing

方案2：替换upsert为updateOrCreate（临时兼容）

如果暂时不想修改表结构，可以把填充器里的upsert逻辑替换为逐行判断的updateOrCreate，性能会略低但小批量数据填充没有感知：

public function run()
{
    $permissions = [
        [
            'name' => 'user-view',
            'label' => 'User View',
            'description' => 'Allows to view users',
            'created_at' => now(),
            'updated_at' => now()
        ],
        // 剩余权限定义保持不变
    ];

    foreach ($permissions as $perm) {
        Permission::updateOrCreate(
            ['name' => $perm['name']],
            $perm
        );
    }
}