Laravel使用updateOrCreate插入SQL Server数据时遇IDENTITY_INSERT错误

问题说明 #

你遇到的报错信息：

[Microsoft][ODBC Driver 17 for SQL Server][SQL Server]Cannot insert explicit value for identity column in table 'XWEB_ANNOUNCE' when IDENTITY_INSERT is set to OFF. (SQL: insert into [XWEB_ANNOUNCE] ([id], [status], [date], [title]) values (1, 1, 12/31/2022 12:00 AM, New Year))

原因是XWEB_ANNOUNCE表的id是IDENTITY自增列，SQL Server默认不允许显式插入值，但你用updateOrCreate时，当找不到id=1的记录，会尝试插入包含id的新数据，触发了这个限制。

解决方案（基于Eloquent） #

方案1：临时开启IDENTITY_INSERT

在模型中添加开关方法，配合updateOrCreate使用：

首先在ANNOUNCE模型里添加两个静态方法：

public static function enableIdentityInsert()
{
    DB::statement("SET IDENTITY_INSERT " . self::getTable() . " ON");
}

public static function disableIdentityInsert()
{
    DB::statement("SET IDENTITY_INSERT " . self::getTable() . " OFF");
}

然后修改控制器方法：

public function do_adminannounce(Request $request)
{
    // 关闭模型事件避免干扰，确保IDENTITY_INSERT只作用于当前操作
    ANNOUNCE::withoutEvents(function () use ($request) {
        ANNOUNCE::enableIdentityInsert();
        ANNOUNCE::updateOrCreate(
            ['id' => 1],
            ['status' => $request->status, 'date' => $request->date, 'title' => $request->title]
        );
        ANNOUNCE::disableIdentityInsert();
    });
    
    return redirect('adminpanel/announce');
}

方案2：拆分更新/插入逻辑

如果业务允许，先尝试更新，更新失败再插入（插入时不指定id）：

public function do_adminannounce(Request $request)
{
    $announce = ANNOUNCE::where('id', 1)->first();
    
    if ($announce) {
        $announce->update([
            'status' => $request->status, 
            'date' => $request->date, 
            'title' => $request->title
        ]);
    } else {
        // 插入时不指定id，让SQL Server自动生成自增值
        ANNOUNCE::create([
            'status' => $request->status, 
            'date' => $request->date, 
            'title' => $request->title
        ]);
        // 若必须插入id=1，改用方案1开启IDENTITY_INSERT后再插入
    }
    
    return redirect('adminpanel/announce');
}

方案3：修改模型自增配置（不推荐）

如果id列实际不需要自增，可在ANNOUNCE模型中添加：

public $incrementing = false;
protected $keyType = 'int'; // 根据实际字段类型调整

注意：若数据库中id确实是IDENTITY自增列，此设置会导致Eloquent与数据库行为不一致，谨慎使用。

内容的提问来源于stack exchange，提问作者Виктор Минчев