EF Core迁移报错：自定义源生成值转换器映射问题求助

问题场景 #

• 自定义源生成器，为标记[GenerateConverters]的记录类（如Height）自动生成对应的HeightValueConverter等值转换器类
• 生成的转换器类位于业务类库中，EF Core项目仅引用该业务类库，未直接引用源生成器项目
• 在EF项目的IEntityTypeConfigurations中通过HasConversion<Height.HeightValueConverter>配置ProfileInformation.Height属性的转换逻辑，但执行迁移命令时，出现无法创建DbContext实例的错误，提示Height类型无法映射，数据库不支持该类型

解决方案 #

1. 确保设计时环境能访问生成的转换器类 #

EF Core的迁移工具属于设计时环境，需要能加载到所有相关类型，包括源生成器生成的转换器。即使业务类库包含生成的代码，若EF项目未间接触发生成器逻辑，设计时环境可能无法识别这些类型：

• 给业务类库添加源生成器项目的引用，并设置PrivateAssets="all"，这样编译时生成器会正常工作，且不会将生成器依赖传递到EF项目：

  <!-- 业务类库的.csproj中添加 -->
  <ProjectReference Include="..\YourGeneratorProject\YourGeneratorProject.csproj" PrivateAssets="all" />
  

• 若业务类库是NuGet包形式，需确保包包含生成器的相关内容，且EF项目安装该包时能触发代码生成逻辑。

2. 实现设计时DbContext工厂 #

迁移时EF会尝试创建DbContext实例，设计时环境的配置可能与运行时存在差异，通过IDesignTimeDbContextFactory可以明确控制DbContext的创建逻辑，避免依赖注入环境的影响：

public class AppDbContextFactory : IDesignTimeDbContextFactory<AppDbContext>
{
    public AppDbContext CreateDbContext(string[] args)
    {
        var optionsBuilder = new DbContextOptionsBuilder<AppDbContext>();
        optionsBuilder.UseSqlServer("Your_Connection_String");

        return new AppDbContext(optionsBuilder.Options);
    }
}

将该类放在EF项目中，迁移工具会优先使用它创建DbContext，确保能正确加载业务类库中的转换器类型。

3. 验证生成的转换器实现正确性 #

检查源生成器输出的代码，确保转换器正确继承自ValueConverter<TModel, TDb>，且转换逻辑无误：

// 示例正确的转换器实现
public class HeightValueConverter : ValueConverter<Height, decimal>
{
    public HeightValueConverter() : base(
        height => height.Value,
        dbValue => new Height(dbValue))
    {
    }
}

若转换器继承关系错误、转换逻辑缺失，EF Core会无法识别其为有效的值转换器，进而判定Height类型无法映射。

4. 清理并重新生成解决方案 #

设计时环境可能缓存旧的编译结果，导致生成的转换器未被加载：

• 依次清理业务类库、EF项目的编译输出
• 重新生成整个解决方案，确认HeightValueConverter已被正确生成到业务类库的输出程序集中

核心原因总结 #

问题本质是EF Core设计时环境无法访问到源生成器生成的转换器类，导致无法识别Height类型的转换配置。通过确保设计时能加载生成类型、规范转换器实现、使用设计时DbContext工厂这几点，即可解决迁移报错问题。

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