Laravel使用syncWithoutDetaching带额外字段时出现id列不存在错误

AI 小北

2026-7-8

问题分析与解决方案

问题原因

出现这个错误的核心原因是：Laravel 默认的 Pivot 类假设中间表（pivot table）存在自增主键 id，但你的 user_activity_log 表使用的是 复合主键（activity_id 和 log_id），没有单独的 id 列。当你第一次调用 syncWithoutDetaching 插入新的关联记录时，Laravel 会尝试获取刚插入记录的 id（但不存在），进而执行了一个错误的查询 select * from user_activity_log where id = 0 limit 1。

而第二次提交时，关联记录已经存在，syncWithoutDetaching 不会执行插入操作，也就不会触发这个错误。

解决方案

要解决这个问题，你需要创建一个自定义中间表模型，明确指定复合主键，告诉 Laravel 不要使用默认的 id 作为主键。

步骤 1：创建自定义中间表模型

在 app/Models 目录下创建 UserActivityLogPivot.php 文件：

namespace App\Models;

use Illuminate\Database\Eloquent\Relations\Pivot;

class UserActivityLogPivot extends Pivot
{
    // 指定对应的中间表名
    protected $table = 'user_activity_log';
    
    // 设置复合主键
    protected $primaryKey = ['activity_id', 'log_id'];
    
    // 关闭自增主键（因为使用复合键）
    public $incrementing = false;
}

步骤 2：更新关联关系定义

在 Log 和 Activity 模型的关联方法中，通过 using() 方法指定使用自定义的中间表模型：

Log 模型：

public function activities()
{
    return $this->belongsToMany(
        Activity::class, 'user_activity_log', 'log_id', 'activity_id')
        ->withPivot(['sets', 'reps'])
        ->using(UserActivityLogPivot::class); // 添加这一行
}

Activity 模型：

public function logs()
{
    return $this->belongsToMany(
        Log::class, 'user_activity_log', 'activity_id', 'log_id')
        ->withPivot(['sets', 'reps'])
        ->using(UserActivityLogPivot::class); // 添加这一行
}