.NET 8 EF Core条件编译与SQL生成不一致问题求助

问题确认 #

你遇到的是EF Core模型元数据与项目编译上下文不一致导致的问题：

• 条件编译是项目编译阶段生效的，但EF Core的模型构建依赖编译后的程序集元数据。当使用文件链接共享实体类时，若MAUI项目的EF Core模型缓存复用了其他项目的编译元数据，或者链接文件的编译上下文未被EF Core正确读取，就会出现特性配置与实际生成SQL不符的情况。
• 迁移工具能正确识别是因为迁移是针对具体项目执行的，编译上下文明确，直接读取当前项目编译后的实体类元数据；而SQL生成器可能复用了之前构建的模型缓存，导致未读取到条件编译后的DatabaseGenerated(None)特性。

优雅解决方案 #

1. 用Fluent API替代特性配置（推荐） #

放弃在实体类中用条件编译特性，转而在各项目的DbContext中通过Fluent API配置，完全绕开元数据缓存问题：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    var entityConfig = modelBuilder.Entity<MyEntity>();

#if PROJECT_TABLET
    // SQLite 配置：不自动生成值
    entityConfig.Property(e => e.AlternateId)
        .ValueGeneratedNever();
#else
    // SQL Server 配置：数据库计算生成
    entityConfig.Property(e => e.AlternateId)
        .ValueGeneratedOnAddOrUpdate();
#endif
}

这种方式直接在项目专属的DbContext中配置，编译上下文明确，不会出现元数据不一致的问题，也更符合EF Core的最佳实践。

2. 清理缓存并验证编译上下文 #

• 检查MAUI项目的预定义符号：确认PROJECT_TABLET在**所有构建配置（Debug/Release）**中都已添加（项目属性→生成→常规→条件编译符号）。
• 清理解决方案：删除所有项目的bin、obj文件夹，重新编译整个解决方案，避免旧的编译缓存干扰模型元数据读取。
• 验证链接文件属性：右键MAUI项目中的链接文件→属性，确认“生成操作”为“编译”。

3. 拆分数据库专属实体配置 #

将不同数据库的实体配置拆分到项目专属的配置类中，进一步分离关注点：

// Blazor Server 项目专属配置
public class MyEntitySqlServerConfig : IEntityTypeConfiguration<MyEntity>
{
    public void Configure(EntityTypeBuilder<MyEntity> builder)
    {
        builder.Property(e => e.AlternateId).ValueGeneratedOnAddOrUpdate();
    }
}

// MAUI 项目专属配置
public class MyEntitySqliteConfig : IEntityTypeConfiguration<MyEntity>
{
    public void Configure(EntityTypeBuilder<MyEntity> builder)
    {
        builder.Property(e => e.AlternateId).ValueGeneratedNever();
    }
}

然后在各自DbContext中应用配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
#if PROJECT_TABLET
    modelBuilder.ApplyConfiguration(new MyEntitySqliteConfig());
#else
    modelBuilder.ApplyConfiguration(new MyEntitySqlServerConfig());
#endif
}

问题反馈渠道 #

• 直接在EF Core的GitHub仓库提交Issue，详细描述问题场景（.NET 8版本、MAUI/Blazor Server项目、文件链接复用实体类、条件编译配置），并附上可重现的最小化代码示例。
• 在.NET官方开发者社区发帖，说明问题细节，寻求官方团队或社区专家的进一步分析。

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