Laravel 8 使用带UUID主键的Factory填充数据报NOT NULL错误如何解决？

核心问题原因 #

你遇到的id为null的报错，本质是工厂生成的UUID值没有被正确写入数据库，常见诱因有2个：

1. Str::uuid() 返回的是Ramsey\Uuid\UuidInterface实例对象，而非直接的字符串，部分Laravel版本下ORM无法自动将其转换为字符串写入，最终被处理为null
2. 手动在工厂中指定id生成逻辑容易被其他模型逻辑/关联调用覆盖，稳定性差

可直接落地的修复方案 #

方案1：优化工厂的id赋值（快速修复） #

将Issue工厂中id的生成代码改为显式转字符串，同时删除写死的edition_id配置，避免和for()方法的自动填充逻辑冲突：

return [
    'id' => (string) Str::uuid(), // 也可以写成Str::uuid()->toString()
    'issuing_date' => $randomDate,
];

同时确认工厂顶部导入了正确的Str门面：use Illuminate\Support\Str;

方案2：模型层统一处理UUID生成（更稳妥，推荐） #

完全删除工厂中的id赋值逻辑，直接在Issue模型中添加创建时自动生成UUID的逻辑，不管是工厂填充还是业务代码创建都会自动生效，避免后续重复踩坑：

1. 首先确认模型顶部导入Str门面：use Illuminate\Support\Str;
2. 给Issue模型添加booted方法：

protected static function booted()
{
    static::creating(function (Issue $issue) {
        if (empty($issue->id)) {
            $issue->id = (string) Str::uuid();
        }
    });
}

额外检查项 #

确认你的Edition表的主键类型和issues表的edition_id字段类型匹配：如果Edition表的主键是UUID类型，你当前迁移中写的$table->integer('edition_id')是错误的，需要改为$table->uuid('edition_id')，否则会触发外键类型不匹配错误。

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