解决 Laravel Activitylog 包中 UUID 主键的兼容性问题

问题背景

在使用 Laravel Activitylog 包时，当用户模型采用 UUID 作为主键类型时，会遇到数据库字段类型不匹配的问题。这是因为 Activitylog 包的默认迁移文件假设所有关联模型都使用自增整数作为主键。

问题表现

当尝试记录活动日志时，系统会抛出数据库异常，因为默认迁移创建的 causer_id 字段是 unsigned bigint 类型，而实际用户模型的 ID 是 UUID 字符串格式，两者类型不匹配导致插入失败。

根本原因

Activitylog 包的默认迁移使用 morphs() 方法创建多态关联字段，该方法默认生成整数类型的外键。对于使用 UUID 作为主键的模型，我们需要使用 uuidMorphs() 方法替代。

解决方案

方法一：修改迁移文件

在发布 Activitylog 包的迁移文件后，立即修改迁移内容：

// 替换原有的
$table->nullableMorphs('subject', 'subject');
$table->nullableMorphs('causer', 'causer');

// 改为
$table->nullableUuidMorphs('subject', 'subject');
$table->nullableUuidMorphs('causer', 'causer');

方法二：创建自定义迁移

如果项目已经运行，可以创建新的迁移文件来修改字段类型：

Schema::table('activity_log', function (Blueprint $table) {
    $table->uuid('causer_id')->change();
    $table->uuid('subject_id')->change();
});

注意事项

1. 修改字段类型前，确保数据库支持从整数到 UUID 的转换
2. 在生产环境执行此类变更前，务必先备份数据库
3. 如果已有数据，需要编写额外的迁移逻辑来处理数据转换

最佳实践

对于新项目，建议在安装 Activitylog 包时就考虑主键类型问题。可以在发布迁移文件前，先检查项目中主要模型使用的主键类型，然后相应地调整迁移内容。

总结

Laravel Activitylog 是一个功能强大的活动日志记录包，但在使用非标准主键类型（如 UUID）时需要特别注意迁移文件的适配。通过简单的字段类型调整，可以轻松解决兼容性问题，使包能够完美支持 UUID 主键的模型。