在ASP.NET Core中如何验证属性唯一性？附检查名称是否已存在的实体类示例

首先先把你给出的Test实体类代码贴出来，方便后续对照：

public class Test 
{ 
    [Key] 
    public int Id{ get; set; } 
    [Required] 
    public string Name { get; set; } 
    public decimal Number { get; set; } 
}

很高兴帮你解决这个问题！在ASP.NET Core里验证实体属性的唯一性，尤其是这个Name字段，有几种实用且层层递进的方案，我一步步给你讲清楚：

方案1：自定义验证特性（DataAnnotations风格） #

这个方案最直观，能直接和现有的[Required]等DataAnnotations特性配合使用，在模型验证阶段就触发检查。

首先创建自定义的UniqueNameAttribute：

using Microsoft.EntityFrameworkCore;
using System.ComponentModel.DataAnnotations;
using System.Linq;

public class UniqueNameAttribute : ValidationAttribute
{
    protected override ValidationResult IsValid(object value, ValidationContext validationContext)
    {
        // 从验证上下文获取你的DbContext实例
        var dbContext = validationContext.GetService(typeof(YourDbContext)) as YourDbContext;
        var name = value as string;
        var currentTest = validationContext.ObjectInstance as Test;

        if (dbContext == null || currentTest == null)
        {
            return new ValidationResult("无法完成名称唯一性验证");
        }

        // 关键：编辑场景下要排除当前实体自己，避免误判
        bool isDuplicate = dbContext.Tests
            .Any(t => t.Name == name && t.Id != currentTest.Id);

        if (isDuplicate)
        {
            return new ValidationResult("该名称已存在，请更换其他名称");
        }

        return ValidationResult.Success;
    }
}

然后给Test类的Name属性加上这个特性：

public class Test 
{ 
    [Key] 
    public int Id{ get; set; } 
    [Required]
    [UniqueName] // 新增这一行
    public string Name { get; set; } 
    public decimal Number { get; set; } 
}

之后在Controller里用ModelState.IsValid检查模型时，就会自动触发这个唯一性验证。

方案2：业务逻辑层（Service）手动检查 #

如果你的项目是分层架构，更推荐把验证逻辑放在Service层，这样逻辑更集中，也方便在多个地方复用。

先创建TestService：

using Microsoft.EntityFrameworkCore;

public class TestService
{
    private readonly YourDbContext _dbContext;

    // 通过依赖注入获取DbContext
    public TestService(YourDbContext dbContext)
    {
        _dbContext = dbContext;
    }

    // 封装通用的唯一性检查方法
    public async Task<bool> IsNameUniqueAsync(string name, int excludeEntityId = 0)
    {
        return !await _dbContext.Tests
            .AnyAsync(t => t.Name == name && t.Id != excludeEntityId);
    }

    // 添加实体的业务逻辑
    public async Task<Test> AddTestAsync(Test test)
    {
        if (!await IsNameUniqueAsync(test.Name))
        {
            throw new InvalidOperationException("该名称已存在，请更换其他名称");
            // 也可以返回自定义的结果对象，比如包含错误信息的ResponseDto，更友好
        }

        _dbContext.Tests.Add(test);
        await _dbContext.SaveChangesAsync();
        return test;
    }

    // 更新实体的业务逻辑
    public async Task<Test> UpdateTestAsync(Test test)
    {
        if (!await IsNameUniqueAsync(test.Name, test.Id))
        {
            throw new InvalidOperationException("该名称已存在，请更换其他名称");
        }

        _dbContext.Tests.Update(test);
        await _dbContext.SaveChangesAsync();
        return test;
    }
}

在Controller里注入TestService，调用对应的方法即可，记得捕获异常或者处理错误信息返回给前端。

方案3：数据库层面添加唯一约束（兜底方案） #

前面两种方案在高并发场景下可能存在“检查-插入”的竞态条件：两个请求同时检查Name不存在，然后同时插入，导致重复数据。所以必须在数据库层面加唯一约束作为最后一道防线。

用EF Core的Fluent API配置：

public class YourDbContext : DbContext
{
    public DbSet<Test> Tests { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 给Name字段添加唯一索引
        modelBuilder.Entity<Test>()
            .HasIndex(t => t.Name)
            .IsUnique();
    }

    // 其他DbContext配置...
}

然后运行迁移命令更新数据库：

Add-Migration AddUniqueIndexToTestName
Update-Database

此时如果有重复插入，EF Core会抛出DbUpdateException，你需要在代码里捕获这个异常并转换成友好的错误提示：

public async Task<Test> AddTestAsync(Test test)
{
    try
    {
        _dbContext.Tests.Add(test);
        await _dbContext.SaveChangesAsync();
        return test;
    }
    catch (DbUpdateException ex)
    {
        // 针对SQL Server的唯一约束冲突错误码（2601/2627）
        if (ex.InnerException is SqlException sqlEx && 
            (sqlEx.Number == 2601 || sqlEx.Number == 2627))
        {
            throw new InvalidOperationException("该名称已存在，请更换其他名称", ex);
        }
        // 其他异常原样抛出
        throw;
    }
}

注意：不同数据库的唯一约束冲突错误码不同，比如MySQL是1062，需要根据你的数据库类型调整判断条件。

推荐实践 #

我个人推荐三种方案结合使用：

• 用自定义验证特性做前端/模型的即时验证，提升用户体验；
• 在Service层做业务逻辑检查，提前拦截错误；
• 数据库唯一约束作为最后一道防线，彻底避免并发场景下的重复数据。

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