Laravel API并发重复请求：如何避免完整性约束冲突？

我有一个Laravel API，需要向某数据表插入数据，该表的两个字段设有唯一约束。当存在并发或重复请求时，MariaDB会因同时插入重复数据抛出完整性约束冲突错误：

SQLSTATE[23000]: Integrity constraint violation: 1062 Duplicate entry 'some_value' for key 'unique_column'

我已尝试的方案：

• Try-Catch块：使用try-catch捕获异常，但仅能捕获错误，无法阻止重复插入；
• 插入前校验：使用Model::where('column', $value)->exists()先校验，但该操作非原子性，仍存在竞态条件。

最优解决方案 #

1. 使用firstOrCreate/updateOrCreate（推荐） #

Laravel内置的firstOrCreate和updateOrCreate方法是数据库层面的原子操作，会一次性完成「查询+插入/更新」，从根源上避免竞态条件。

插入场景（不存在则创建）

$model = YourModel::firstOrCreate(
    // 唯一约束字段组合，用于查询匹配
    ['column1' => $value1, 'column2' => $value2],
    // 新增时需要填充的其他字段
    ['other_column' => $otherValue]
);

更新场景（存在则更新）

如果需要在记录存在时更新指定字段，使用updateOrCreate：

$model = YourModel::updateOrCreate(
    ['column1' => $value1, 'column2' => $value2],
    ['other_column' => $updatedValue]
);

2. 事务+悲观锁（适配复杂业务逻辑） #

如果插入前需要执行额外业务逻辑，可通过数据库事务结合悲观锁，确保查询与插入的原子性：

DB::transaction(function () use ($value1, $value2, $otherValue) {
    // 对匹配记录加排他锁，并发请求需等待当前事务完成
    $existing = YourModel::where('column1', $value1)
        ->where('column2', $value2)
        ->lockForUpdate()
        ->first();

    if (!$existing) {
        YourModel::create([
            'column1' => $value1,
            'column2' => $value2,
            'other_column' => $otherValue
        ]);
    }
});

lockForUpdate会锁定查询到的记录（或锁定空结果集的位置），避免其他请求在当前事务结束前插入重复数据。

3. 优化Try-Catch兜底策略 #

若无法使用上述原子方法，可优化异常捕获逻辑，在触发唯一约束冲突时直接返回已存在的记录：

try {
    $model = YourModel::create([
        'column1' => $value1,
        'column2' => $value2,
        'other_column' => $otherValue
    ]);
} catch (\Illuminate\Database\QueryException $e) {
    // 判定是否为唯一约束冲突错误
    if ($e->getCode() === '23000') {
        $model = YourModel::where('column1', $value1)
            ->where('column2', $value2)
            ->first();
    } else {
        // 非约束异常重新抛出
        throw $e;
    }
}

内容的提问来源于stack exchange，提问作者adithyan.cs