C#中如何捕获和处理数据库异常?常见异常有哪些?

来源:这里教程网 时间:2026-02-21 17:28:07 作者:

在C#中操作数据库时,异常处理是确保程序稳定运行的关键环节。通常使用 try-catch 块来捕获数据库相关的异常,尤其是针对 System.Data.SqlClientMicrosoft.Data.SqlClient 等数据库提供程序抛出的特定异常类型。

如何捕获和处理数据库异常

使用 try-catch 捕获数据库操作中的异常,建议优先捕获具体的异常类型,再处理通用异常。

示例:使用 SqlConnection 和 SqlCommand 进行数据库操作并处理异常
using System;
using System.Data.SqlClient;
<p>try
{
using (SqlConnection conn = new SqlConnection("your_connection_string"))
{
conn.Open();
using (SqlCommand cmd = new SqlCommand("SELECT * FROM NonExistentTable", conn))
{
SqlDataReader reader = cmd.ExecuteReader();
while (reader.Read())
{
// 处理数据
}
}
}
}
catch (SqlException ex)
{
// 处理 SQL Server 特定异常
Console.WriteLine($"SQL错误 (错误号: {ex.Number}): {ex.Message}");
switch (ex.Number)
{
case 4060: // 登录失败
Console.WriteLine("数据库登录失败,请检查用户名或密码。");
break;
case 18456: // 登录失败(更详细的认证错误)
Console.WriteLine("身份验证失败。");
break;
case 2: // 连接超时或找不到服务器
case -2: // 超时
Console.WriteLine("连接数据库超时,请检查网络或服务器状态。");
break;
case 547: // 外键或约束冲突
Console.WriteLine("操作违反数据库约束(如外键、检查约束)。");
break;
case 2627: // 主键冲突
Console.WriteLine("尝试插入重复的主键值。");
break;
default:
Console.WriteLine($"其他数据库错误: {ex.Message}");
break;
}
}
catch (InvalidOperationException ex)
{
Console.WriteLine($"无效操作: {ex.Message}");
// 常见于连接已关闭时执行命令
}
catch (ArgumentException ex)
{
Console.WriteLine($"参数错误: {ex.Message}");
// 如连接字符串格式错误
}
catch (Exception ex)
{
Console.WriteLine($"未预期的错误: {ex.Message}");
}</p>

常见的数据库异常类型及原因

C# 中访问 SQL Server 数据库时,最常遇到的异常来自以下几个类型:

1. SqlException
由 SQL Server 返回的错误引发,通过 Number 属性识别具体错误码。

错误号 2 / -2:连接超时或服务器无法访问 错误号 4060:登录失败,数据库不存在 错误号 18456:登录失败,用户身份验证错误 错误号 547:外键约束、CHECK 约束或触发器阻止操作 错误号 2627:违反唯一约束或主键冲突 错误号 1205:死锁 错误号 102:SQL 语法错误

2. InvalidOperationException
常见于以下情况:

在已关闭的连接上执行命令 DataReader 已关闭但仍尝试读取数据 异步操作未正确完成就调用 EndExecute

3. ArgumentException / ArgumentNullException
通常由于连接字符串为空、格式错误,或传入 null 参数导致。

4. TimeoutException
命令执行超时(CommandTimeout)或连接等待超时。虽然有时表现为 SqlException(如错误号 -2),但在某些场景下也可能单独抛出。

最佳实践建议

始终使用 using 语句确保连接、命令、DataReader 被正确释放 根据 SqlException.Number 做精细化错误处理 避免暴露敏感信息(如完整连接字符串、表结构)给前端用户 记录异常详情用于排查,但向用户展示友好提示 对可重试异常(如超时、死锁)实现重试机制

基本上就这些。掌握常见异常类型并合理捕获,能显著提升数据库应用的健壮性。

相关推荐