SQL Server数据库插入记录时抛出异常，求解决方案

1. 权限受限 #

• 连接数据库的账号仅拥有读取权限，没有插入/写入权限。哪怕之前测试正常，也可能是账号权限被修改，或是部署环境使用了不同的连接串账号。
• 解决：查看连接字符串里的登录账号，在SQL Server Management Studio（SSMS）中确认该账号对目标表拥有INSERT权限。如果用的是集成身份验证，要确保运行应用的Windows账户具备对应权限。

2. 约束冲突或表结构变更 #

• 目标表后续新增了非空约束、外键约束、唯一约束，或是修改了字段数据类型，而你插入的新记录不符合这些规则。比如必填字段未赋值、外键字段关联的主表无对应记录、唯一字段插入了重复值。
• 解决：
  • 打开SSMS查看目标表的约束和结构，对比插入时传入的参数是否匹配。
  • 抓取异常的具体错误信息，通常会明确指出违反了哪个约束，照着调整即可。

3. 插入语句存在问题 #

• 修改插入SQL后出现语法错误，或是未使用参数化查询，导致特殊字符（如单引号）引发语法异常，又或是参数类型与字段类型不匹配。
• 解决：
  • 在代码中打印实际执行的SQL语句，复制到SSMS中直接执行，排查具体报错点。
  • 务必使用参数化查询，既避免SQL注入又解决类型匹配问题，示例代码：

    using (var conn = new SqlConnection(connectionString))
    {
        conn.Open();
        var sql = "INSERT INTO YourTable (Col1, Col2) VALUES (@Val1, @Val2)";
        using (var cmd = new SqlCommand(sql, conn))
        {
            cmd.Parameters.AddWithValue("@Val1", yourValue1);
            cmd.Parameters.AddWithValue("@Val2", yourValue2);
            cmd.ExecuteNonQuery();
        }
    }
    

4. 事务或锁阻塞 #

• 之前的操作开启了事务但未提交/回滚，导致目标表被锁定无法插入；或是有其他进程/事务占用了表的写锁。
• 解决：
  • 检查代码中的事务逻辑，确保每个事务都有Commit()或Rollback()操作，避免事务挂起。
  • 在SSMS中通过活动监视器或sp_who2命令查看阻塞进程，确认后终止对应会话（操作需谨慎，避免影响其他业务）。

5. 数据库空间不足 #

• SQL Server的数据文件或日志文件已满，无法写入新数据。
• 解决：在SSMS中查看数据库的文件空间使用情况，要么手动扩展数据/日志文件容量，要么开启文件自动增长功能。

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