如何针对EF Core Fluent API配置编写单元测试？

一、是否需要编写单元测试？ #

有必要。EF Core的Fluent API配置直接决定了领域模型和数据库的映射规则，像表名、主键、字段约束（必填、长度）、关联关系这些配置如果出错，往往要到运行时执行数据库操作才会暴露问题，单元测试能在开发阶段提前揪出这类错误，避免后续调试麻烦。

你判断MyApp.Domain仅含属性无业务逻辑无需测试是对的，这类纯实体类确实没必要写单元测试。

二、Xunit单元测试实现 #

你可以通过创建EntityTypeBuilder实例，调用配置类的Configure方法，再从构建后的模型元数据里验证映射规则是否符合预期。

所需依赖 #

先安装这些NuGet包：

• Microsoft.EntityFrameworkCore
• xunit
• xunit.runner.visualstudio
• FluentAssertions（可选，让断言更简洁易读）

1. CustomerEntityTypeConfiguration测试示例 #

using Xunit;
using Microsoft.EntityFrameworkCore.Metadata.Builders;
using Microsoft.EntityFrameworkCore;
using MyApp.Domain;
using MyApp.EFConfiguration;
using FluentAssertions;

public class CustomerEntityTypeConfigurationTests
{
    [Fact]
    public void Configure_AppliesCorrectMappingRules()
    {
        // 准备测试环境
        var entityTypeBuilder = new EntityTypeBuilder<Customer>(
            new ModelBuilder().Entity<Customer>().Metadata);
        var configuration = new CustomerEntityTypeConfiguration();

        // 执行配置方法
        configuration.Configure(entityTypeBuilder);
        var entityMetadata = entityTypeBuilder.Metadata;

        // 验证表名
        entityMetadata.GetTableName().Should().Be("Customer");
        
        // 验证主键
        entityMetadata.FindPrimaryKey().Properties.Should().ContainSingle(p => p.Name == nameof(Customer.Id));
        
        // 验证Username字段约束
        var usernameProp = entityMetadata.FindProperty(nameof(Customer.Username));
        usernameProp.IsRequired.Should().BeTrue();
        usernameProp.GetMaxLength().Should().Be(255);
        
        // 验证FirstName字段约束
        var firstNameProp = entityMetadata.FindProperty(nameof(Customer.FirstName));
        firstNameProp.IsRequired.Should().BeTrue();
        firstNameProp.GetMaxLength().Should().Be(255);
        
        // 验证LastName字段约束
        var lastNameProp = entityMetadata.FindProperty(nameof(Customer.LastName));
        lastNameProp.IsRequired.Should().BeTrue();
        lastNameProp.GetMaxLength().Should().Be(255);
    }
}

2. OrderEntityTypeConfiguration测试示例 #

using Xunit;
using Microsoft.EntityFrameworkCore.Metadata.Builders;
using Microsoft.EntityFrameworkCore;
using MyApp.Domain;
using MyApp.EFConfiguration;
using FluentAssertions;

public class OrderEntityTypeConfigurationTests
{
    [Fact]
    public void Configure_AppliesCorrectMappingRules()
    {
        // 准备测试环境，先配置Customer以支持关联关系验证
        var modelBuilder = new ModelBuilder();
        modelBuilder.ApplyConfiguration(new CustomerEntityTypeConfiguration());
        var entityTypeBuilder = modelBuilder.Entity<Order>();
        var configuration = new OrderEntityTypeConfiguration();

        // 执行配置方法
        configuration.Configure(entityTypeBuilder);
        var entityMetadata = entityTypeBuilder.Metadata;

        // 验证表名
        entityMetadata.GetTableName().Should().Be("Orders");
        
        // 验证主键
        entityMetadata.FindPrimaryKey().Properties.Should().ContainSingle(p => p.Name == nameof(Order.Id));
        
        // 验证CustomerId字段约束
        var customerIdProp = entityMetadata.FindProperty(nameof(Order.CustomerId));
        customerIdProp.IsRequired.Should().BeTrue();
        
        // 验证CurrencyRate字段约束
        var currencyRateProp = entityMetadata.FindProperty(nameof(Order.CurrencyRate));
        currencyRateProp.IsRequired.Should().BeTrue();
        
        // 验证Customer关联关系
        var customerNavigation = entityMetadata.FindNavigation(nameof(Order.Customer));
        customerNavigation.Should().NotBeNull();
        customerNavigation.IsRequired.Should().BeTrue();
        
        // 验证Orders反向关联
        var ordersNavigation = modelBuilder.Entity<Customer>().Metadata.FindNavigation(nameof(Customer.Orders));
        ordersNavigation.Should().NotBeNull();
        
        // 验证外键配置
        var foreignKey = entityMetadata.FindForeignKey(new[] { customerIdProp });
        foreignKey.Should().NotBeNull();
        foreignKey.PrincipalEntityType.ClrType.Should().Be(typeof(Customer));
        foreignKey.PrincipalKey.Properties.Should().ContainSingle(p => p.Name == nameof(Customer.Id));
    }
}

三、补充说明 #

• 如果你不想用FluentAssertions，把断言替换成Xunit原生的Assert类即可，比如Assert.Equal("Customer", entityMetadata.GetTableName())。
• 测试关联关系时，必须先配置关联的实体（比如Customer），否则模型元数据不完整会导致断言失败。
• 你可以根据实际配置扩展测试点，比如字段数据类型、索引、默认值等。

内容的提问来源于stack exchange，提问作者I Love Stackoverflow