Laravel Eloquent多对多关联sync操作存储用户id而非uuid问题求助

问题原因 #

Laravel Eloquent默认所有模型的主键为id（自增整型），执行关联写入操作时默认取主键字段值写入中间表，你未显式指定自定义关联键的情况下，就会出现存id而非user_uuid的问题。

排查步骤 #

• 首先确认User模型是否配置了自定义主键属性
• 再检查Task模型的主键配置是否匹配关联逻辑（如果Task也使用uuid作为主键）
• 最后校验中间表user_task的user_uuid、task_uuid字段类型是否和主表对应字段类型一致

解决方法 #

方案1：将uuid设置为模型主键（推荐，符合uuid作为唯一标识的设计逻辑） #

修改User模型的主键配置：

class User extends Model
{
    // 显式指定主键字段为user_uuid
    protected $primaryKey = 'user_uuid';
    // 关闭主键自增
    public $incrementing = false;
    // 指定主键类型为字符串
    protected $keyType = 'string';

    // 原有tasks关联方法无需修改
    public function tasks() { 
        return $this->belongsToMany(Task::class, 'user_task', 'user_uuid', 'task_uuid'); 
    }
}

如果Task模型也使用task_uuid作为主键，同步修改Task模型配置：

class Task extends Model
{
    protected $primaryKey = 'task_uuid';
    public $incrementing = false;
    protected $keyType = 'string';

    // 原有users关联方法无需修改
    public function users() { 
        return $this->belongsToMany(User::class, 'user_task', 'task_uuid', 'user_uuid'); 
    }
}

方案2：不修改模型主键，直接补充关联的本地键参数 #

如果你的User模型主键仍然保留默认的id，仅需要中间表存储user_uuid作为关联标识，直接修改关联定义即可：

// User模型的tasks关联
public function tasks() { 
    // 第5个参数为当前模型要关联的本地字段（user_uuid），第6个参数为Task模型的关联本地字段
    return $this->belongsToMany(Task::class, 'user_task', 'user_uuid', 'task_uuid', 'user_uuid', 'task_uuid'); 
}

修改完成后重新调用sync接口，中间表就会正确写入user_uuid的值。

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