Entity Framework插入重复数据时无法捕获数据库异常的解决方法

问题分析 #

你通过HasIndex(e => e.Email).IsUnique()在数据库层面创建了邮箱唯一约束，但插入重复邮箱时SaveChangesAsync未触发异常捕获，核心原因是：EF Core会将数据库抛出的约束冲突异常包装为DbUpdateException，若未针对性捕获或排查异常链，可能误以为没有异常抛出。

正确的异常捕获实现 #

直接捕获DbUpdateException，并根据底层数据库的错误码判断是否为唯一约束冲突，示例代码如下：

public async Task CommitAsync(CancellationToken cancellationToken = default)
{
    try
    {
        await context.SaveChangesAsync(cancellationToken);
    }
    catch (DbUpdateException ex)
    {
        // 针对SQL Server的唯一约束错误码判断（2601=唯一索引冲突，2627=唯一约束冲突）
        if (ex.InnerException is SqlException sqlEx)
        {
            foreach (SqlError error in sqlEx.Errors)
            {
                if (error.Number is 2601 or 2627)
                {
                    // 抛出自定义异常或直接处理
                    throw new InvalidOperationException("该邮箱已被注册", ex);
                }
            }
        }
        // 非唯一约束的数据库异常，重新抛出
        throw;
    }
}

不同数据库的错误码参考 #

• SQL Server：2601、2627
• SQLite：19
• PostgreSQL：23505
• MySQL：1062

额外注意事项 #

1. 不要依赖客户端验证：即使在业务层提前查询邮箱是否存在，并发场景下仍可能出现冲突，必须以数据库层面的异常捕获作为最终保障。
2. 避免使用SaveChangesFailed事件：该事件属于全局回调，容易引发竞态条件，不符合异常处理的常规流程，不推荐用于业务逻辑中的异常捕获。
3. 检查异步调用是否正确await：若上层调用CommitAsync时未使用await，异常会被静默吞掉，需确保异步操作被正确等待。

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