Laravel中Str::uuid()生成重复值引发唯一约束冲突问题求助

一、修复UUID重复冲突的问题 #

你遇到的问题根源在于：迁移代码里的Str::uuid()是在迁移执行的瞬间生成一个固定UUID，并将其设为列的默认值，所有新插入的记录都会复用这个UUID，自然触发唯一约束冲突。

正确的实现方式有两种： #

方式1：通过模型boot方法自动生成UUID

在Category模型中添加以下代码，让模型在创建新记录时自动生成唯一UUID：

use Illuminate\Support\Str;
use Illuminate\Database\Eloquent\Model;

class Category extends Model
{
    // 指定主键为字符串类型，关闭自增
    protected $keyType = 'string';
    public $incrementing = false;

    protected static function boot()
    {
        parent::boot();

        // 监听模型创建事件，自动生成UUID
        static::creating(function ($model) {
            if (empty($model->id)) {
                $model->id = Str::uuid();
            }
        });
    }
}

同时修改迁移代码，去掉default(Str::uuid())：

$table->uuid('id')->primary();

方式2：使用Laravel内置HasUuids trait（Laravel 8+适用）

Laravel 8及以上版本提供了更简洁的实现，直接在模型中引入HasUuids trait即可：

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Concerns\HasUuids;

class Category extends Model
{
    use HasUuids;

    // 指定主键为字符串类型，关闭自增
    protected $keyType = 'string';
    public $incrementing = false;
}

迁移代码同样修改为：

$table->uuid('id')->primary();

这样每次创建新的Category实例并保存时，都会自动生成唯一UUID，不会出现重复问题。

二、UUID vs 自增数字主键的选择 #

自增数字主键的适用场景与优势 #

• 性能更优：数字类型的索引效率远高于字符串（UUID），大数据量表中查询、排序、关联操作速度更快，占用存储空间更小。
• 使用便捷：数字ID更简洁，便于调试、URL传递和数据跟踪，比如/categories/5比UUID格式的URL更友好。
• 排序直观：自增ID默认按创建时间排序，分页和数据遍历逻辑更简单。

适合：小型单体应用、无分布式需求的系统、对性能要求较高的场景。

UUID主键的适用场景与优势 #

• 分布式友好：在多数据库实例、微服务架构中，无需依赖数据库自增机制就能生成唯一ID，避免跨实例ID冲突。
• 隐私保护：不会暴露系统的数据规模和增长速度，比如用户ID用UUID时，无法通过ID猜测平台用户数量。
• 防爬取风险：防止恶意用户通过递增ID批量爬取数据。

适合：分布式系统、微服务架构、有隐私保护需求的应用。

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