使用SqlClient在SQL Server中获取插入ID时遇异常的技术问询

我太懂这个坑了！之前用.NET Framework的SqlClient时也踩过一模一样的雷，报错提示找不到INSERTED.Id其实大多是因为SQL语句的结构不对，或者代码里的命令配置有问题。下面给你拆解原因和解决办法：

一、先搞懂报错的核心原因 #

INSERTED是SQL Server在DML操作（INSERT/UPDATE/DELETE）过程中生成的临时逻辑表，只能在同一条DML语句的上下文里访问。如果你的SQL语句是分开写的（比如先执行INSERT，再单独写SELECT INSERTED.Id），数据库根本找不到这个临时表，自然会报错。

二、正确的实现方式（两种常用写法） #

写法1：用OUTPUT子句直接返回插入ID #

这是最安全的方式，也是你提到的帖子里推荐的方案，把INSERT和返回ID的逻辑放在同一条语句里：

1. 正确的SQL语句

INSERT INTO YourTableName (Column1, Column2)
OUTPUT INSERTED.Id  -- 替换成你表中实际的主键/自增列名
VALUES (@Val1, @Val2)

2. .NET代码实现

using (SqlConnection conn = new SqlConnection("你的数据库连接字符串"))
{
    conn.Open();
    string sql = @"INSERT INTO YourTableName (Column1, Column2)
                   OUTPUT INSERTED.Id
                   VALUES (@Val1, @Val2)";
    
    using (SqlCommand cmd = new SqlCommand(sql, conn))
    {
        // 添加参数，避免SQL注入
        cmd.Parameters.AddWithValue("@Val1", "测试值1");
        cmd.Parameters.AddWithValue("@Val2", "测试值2");
        
        // 执行命令并获取返回的ID（如果是bigint类型请转成long）
        int insertedId = (int)cmd.ExecuteScalar();
        Console.WriteLine($"插入的行ID是：{insertedId}");
    }
}

写法2：结合SCOPE_IDENTITY()（兼容老场景） #

如果你因为某些原因没法用OUTPUT子句，也可以用SCOPE_IDENTITY()，它会返回当前会话当前作用域里最后插入的自增ID，安全性也很高：

SQL语句

INSERT INTO YourTableName (Column1, Column2)
VALUES (@Val1, @Val2);
SELECT SCOPE_IDENTITY();

.NET代码实现

和上面逻辑一致，同样用ExecuteScalar()获取返回值即可，注意根据自增列的类型调整转换方式（比如bigint对应long）。

三、常见的错误排查点 #

• 检查SQL语句里的INSERTED.Id是否拼写正确，确保列名和表结构完全匹配（SQL Server不区分大小写，但尽量保持一致避免混淆）。
• 确认你的表确实存在要返回的列，比如如果主键列名叫UserId，写成INSERTED.Id肯定会报错。
• 绝对不要把INSERT和SELECT INSERTED.Id分成两条独立的命令执行，必须放在同一条SQL语句里。

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