.NET 7集成测试EF Core DateOnly映射错误及后续问题排查

问题原因分析 #

1. 测试环境配置未同步主项目：主项目启动时已加载DateOnly的映射规则，但测试用的ApiWebApplicationFactory未正确复用主项目的DbContext配置，导致测试时EF Core无法识别DateOnly类型。
2. 类型转换器未绑定数据库存储类型：仅添加DateOnly转换器但未明确指定对应的数据库存储类型（如SQL Server的date），EF Core无法确定实体属性对应的数据库列类型，触发存储类型缺失错误。

排查步骤 #

• 检查ApiWebApplicationFactory的服务注册逻辑，确认是否复用了主项目的DbContext配置，而非重新定义独立配置。
• 验证测试数据库的迁移状态，确保测试库已执行与主项目完全一致的迁移脚本，避免数据库结构不匹配。

具体解决办法 #

1. 统一DbContext的DateOnly映射配置 #

在主项目的DbContext的OnModelCreating方法中，明确配置DateOnly属性的数据库映射规则，确保主项目与测试项目共用同一逻辑：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 针对实体的DateOnly属性配置映射
    modelBuilder.Entity<YourTargetEntity>()
        .Property(e => e.YourDateOnlyField)
        .HasColumnType("date") // 指定数据库存储类型（SQL Server为date）
        .HasConversion(new DateOnlyConverter());

    // 其他模型配置...
}

// 自定义DateOnly与DateTime的转换器（EF Core 7+也可使用原生支持，无需自定义）
public class DateOnlyConverter : ValueConverter<DateOnly, DateTime>
{
    public DateOnlyConverter() : base(
        dateOnly => dateOnly.ToDateTime(TimeOnly.MinValue),
        dateTime => DateOnly.FromDateTime(dateTime))
    {
    }
}

注：若使用SQL Server，EF Core 7已原生支持DateOnly类型，可直接使用HasColumnType("date")无需自定义转换器，但需确保DbContext配置中未覆盖此规则。

2. 确保测试项目复用主项目DbContext配置 #

修改ApiWebApplicationFactory的服务配置逻辑，移除原有DbContext注册并重新注册测试库连接，但保留主项目的模型配置：

public class ApiWebApplicationFactory<TProgram> : WebApplicationFactory<TProgram> where TProgram : class
{
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        builder.ConfigureServices(services =>
        {
            // 移除默认DbContext注册
            var dbContextDescriptor = services.SingleOrDefault(
                d => d.ServiceType == typeof(DbContextOptions<YourDbContext>));
            if (dbContextDescriptor != null)
            {
                services.Remove(dbContextDescriptor);
            }

            // 注册测试用DbContext，复用主项目的模型配置
            services.AddDbContext<YourDbContext>(options =>
            {
                options.UseSqlServer("你的测试数据库连接字符串");
                // 不要在此处重写OnModelCreating，确保使用主项目的配置
            });
        });
    }
}

3. 强制测试数据库执行迁移 #

在测试类的初始化逻辑中，确保测试数据库已应用最新迁移：

public class YourIntegrationTests : IClassFixture<ApiWebApplicationFactory<Program>>
{
    private readonly HttpClient _client;
    private readonly YourDbContext _dbContext;

    public YourIntegrationTests(ApiWebApplicationFactory<Program> factory)
    {
        _client = factory.CreateClient();
        
        // 获取DbContext实例并执行迁移
        var scope = factory.Services.CreateScope();
        _dbContext = scope.ServiceProvider.GetRequiredService<YourDbContext>();
        _dbContext.Database.Migrate();
    }

    // 测试方法示例
    [Fact]
    public async Task TestApiEndpoint()
    {
        // 测试逻辑...
    }
}

4. 验证EF Core版本一致性 #

确认主项目与测试项目的EF Core相关包（如Microsoft.EntityFrameworkCore、Microsoft.EntityFrameworkCore.SqlServer）版本完全一致，均为.NET 7对应的7.x版本，避免版本差异导致的特性支持问题。

内容的提问来源于stack exchange，提问作者Сереженька