Laravel数据库事务中使用sync方法出现user_id为空的约束错误

问题分析 #

你遇到的user_id cannot be null错误，本质并非事务未创建User实例，而是在部分场景下firstOrCreate返回的模型实例未正确加载id属性——可能是字段值存在隐式处理（如空格）、模型事件干扰，或是事务内模型状态未同步导致。

解决方案 #

方案1：调用refresh()同步模型状态 #

在firstOrCreate后调用refresh()，强制从数据库拉取最新的模型数据，确保id属性被正确赋值：

$user = User::firstOrCreate([
    'username' => trim($row['username']), // 处理可能的前后空格问题
],[
    'name' => $row['name'],
    'surname' => $row['surname'],
    'email' => $row['email'],
])->refresh();

// 过滤拆分后可能存在的空值，避免无效关联操作
$user->roles()->sync(array_filter(explode(',', $row['roles'])));

方案2：手动使用findOrNew + save #

这种方式更明确地触发持久化操作，规避firstOrCreate隐式逻辑可能带来的问题：

$username = trim($row['username']);
$user = User::where('username', $username)->first();

if (!$user) {
    $user = new User([
        'username' => $username,
        'name' => $row['name'],
        'surname' => $row['surname'],
        'email' => $row['email'],
    ]);
    $user->save();
}

$user->roles()->sync(array_filter(explode(',', $row['roles'])));

额外注意事项 #

• 确保User模型的$fillable属性包含所有需要批量赋值的字段（username、name、surname、email）
• 对roles字段的拆分结果做空值过滤，防止向中间表插入无效数据
• 若仍存在问题，可检查数据库事务隔离级别，确保事务内的模型操作能正常读取自增ID

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