自增ID插入失败：无法将NULL插入'id'列问题排查

错误信息：

无法将值NULL插入列'id'，表'GigHub.dbo.Gigs'；列不允许空值。INSERT 失败。系统已终止。

原表结构：

CREATE TABLE dbo.Gigs 
(
    id INT PRIMARY KEY,
    [title] NVARCHAR(MAX) NOT NULL,
    [description] NVARCHAR(MAX) NOT NULL,
    [location] NVARCHAR(MAX) NOT NULL,
    [gigType] INT NOT NULL,
    [startDate] DATETIME NOT NULL,
    [endDate] DATETIME NOT NULL,
    [rate] DECIMAL(10, 2) NOT NULL,
    [gigStatus] INT NOT NULL,
    [createdDate] DATETIME NOT NULL,
    [requirements] NVARCHAR(MAX),
    [gigPoser_id] INT FOREIGN KEY REFERENCES dbo.Users(id) -- 发布兼职的用户ID
);

已执行的自增修改语句：

ALTER TABLE dbo.Gigs
    ALTER COLUMN id INT IDENTITY NOT NULL

使用SQL Server 2022、C# + Dapper，调用存储过程sp_InsertGigs_2插入数据，存储过程代码：

ALTER PROCEDURE [dbo].[sp_InsertGigs_2] 
    @title nvarchar(255),
    @description ntext,
    @location nvarchar(1000), 
    @type nvarchar(355),
    @start_date date,
    @end_date date,
    @rate decimal(10,2),
    @status nvarchar(355),
    @gigPoster_id int,
    @date_created datetime,
    @skills_required nvarchar(MAX),     

    @id int output
    AS
    BEGIN
        
        SET NOCOUNT ON;
        SET IDENTITY_INSERT dbo.Gigs ON;

        insert into dbo.Gigs(id, title, description, location, type, start_date, end_date, rate, status, gigPoster_id, date_created, skills_required)
        values(@id, @title, @description, @location, @type, @start_date, @end_date, @rate, @status, @gigPoster_id, @date_created, @skills_required);

        SET IDENTITY_INSERT dbo.Gigs OFF

        select @id = SCOPE_IDENTITY();      
    END

疑问：已将id设为自增仍插入失败，原因是什么？应用代码或存储过程需做哪些处理？

原因分析 #

1. 错误开启IDENTITY_INSERT：你手动开启了IDENTITY_INSERT dbo.Gigs ON，这会强制要求INSERT语句必须显式提供id值，但应用代码没给@id参数赋值，导致传入NULL触发报错。
2. INSERT语句多余指定id列：即使id是自增列，你在INSERT里显式写了id列，同时传入未赋值的@id参数，自然会插入NULL。
3. 字段名不匹配：原表字段是gigType、gigStatus、createdDate、requirements，但存储过程用的是type、status、date_created、skills_required，字段映射错误会导致后续更多问题。

修复步骤 #

1. 修改存储过程，移除IDENTITY_INSERT并对齐字段名 #

自增列不需要手动插入id，让SQL Server自动生成即可，修改后的存储过程：

ALTER PROCEDURE [dbo].[sp_InsertGigs_2] 
    @title nvarchar(255),
    @description ntext,
    @location nvarchar(1000), 
    @gigType int, -- 对齐表结构字段名
    @startDate datetime, -- 统一字段命名
    @endDate datetime,
    @rate decimal(10,2),
    @gigStatus int,
    @gigPoster_id int,
    @createdDate datetime,
    @requirements nvarchar(MAX),     

    @id int output
    AS
    BEGIN
        SET NOCOUNT ON;

        -- 不指定id列，让SQL自动生成自增ID
        insert into dbo.Gigs(title, description, location, gigType, startDate, endDate, rate, gigStatus, gigPoster_id, createdDate, requirements)
        values(@title, @description, @location, @gigType, @startDate, @endDate, @rate, @gigStatus, @gigPoster_id, @createdDate, @requirements);

        -- 获取刚生成的自增ID返回给应用
        select @id = SCOPE_IDENTITY();      
    END

2. 调整C#代码的参数传递 #

确保GigModel对象字段和存储过程参数一一对应，不要给id属性赋值（或赋值为0/DBNull，Dapper会自动忽略）。示例代码：

public async Task<int> CreateGig(GigModel gig)
{
    using (var connection = new SqlConnection(_connectionString))
    {
        var parameters = new DynamicParameters();
        parameters.Add("@title", gig.Title);
        parameters.Add("@description", gig.Description);
        parameters.Add("@location", gig.Location);
        parameters.Add("@gigType", gig.GigType);
        parameters.Add("@startDate", gig.StartDate);
        parameters.Add("@endDate", gig.EndDate);
        parameters.Add("@rate", gig.Rate);
        parameters.Add("@gigStatus", gig.GigStatus);
        parameters.Add("@gigPoster_id", gig.GigPosterId);
        parameters.Add("@createdDate", DateTime.Now); // 或从GigModel对象取值
        parameters.Add("@requirements", gig.Requirements);
        parameters.Add("@id", dbType: DbType.Int32, direction: ParameterDirection.Output);

        await connection.ExecuteAsync("sp_InsertGigs_2", parameters, commandType: CommandType.StoredProcedure);
        
        return parameters.Get<int>("@id");
    }
}

3. 验证自增列设置是否生效 #

执行以下语句确认id列的自增属性：

SELECT COLUMNPROPERTY(OBJECT_ID('dbo.Gigs'), 'id', 'IsIdentity') AS IsIdentity;

返回1表示已正确设置为自增列。

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