EF Core类型转换错误：RuntimeProperty无法转为Internal.Property

错误原因 #

你代码里的foreach (Property prop in propsToBeHeaders)试图将EF Core返回的RuntimeProperty实例强制转换为内部类Microsoft.EntityFrameworkCore.Metadata.Internal.Property，但RuntimeProperty只实现了公开的IProperty接口，并非继承自这个内部类。这类内部类属于EF Core的私有实现细节，不应该在业务代码中直接引用，强行转换必然抛出类型转换异常。

修复步骤 #

1. 替换循环变量类型 #

将foreach循环中的Property改为公开接口IProperty，确保引用Microsoft.EntityFrameworkCore.Metadata.IProperty命名空间。

2. 简化属性查询代码 #

ent.GetProperties()本身返回的就是IEnumerable<IProperty>，不需要额外的Select(t => t as IProperty)转换，直接过滤即可。

修改后的完整代码 #

public async Task<MemoryStream> GenerateTemplate(string model)
{
    // 获取目标实体的CLR类型
    var clrType = typeof(Occupation).Assembly.DefinedTypes
        .FirstOrDefault(t => t.IsClass && t.Name.Equals(model));
    if (clrType == null) return null; // 增加空值判断避免后续报错
    
    Type type = clrType;
    var ent = _dbContext.Model.GetEntityTypes()
        .Single(q => q.ClrType == type);

    // 获取带有ExcelColumnAttribute标记的属性
    var propsToBeHeaders = ent.GetProperties()
        .OrderBy(f => f.FieldInfo?.MetadataToken)
        .Where(t => t.PropertyInfo?.GetCustomAttributes(typeof(ExcelColumnAttribute), true) is Attribute[] attributes && attributes.Length > 0)
        .ToList();

    // 生成Excel模板
    MemoryStream stream = new MemoryStream();
    using (var package = new ExcelPackage())
    {
        ExcelWorksheet sheet = package.Workbook.Worksheets.Add(model);
        int i = 1;
        
        foreach (IProperty prop in propsToBeHeaders)
        {
            ExcelColumnAttribute attr = (ExcelColumnAttribute)prop.PropertyInfo
                .GetCustomAttributes(typeof(ExcelColumnAttribute))
                .FirstOrDefault();
            
            if (attr != null) // 增加空值判断避免空引用
            {
                sheet.Cells[1, i].Value = attr.Header;
                await SetWorkSheetValidationRules(package, sheet, prop, 2, i, 1048576, i);
                i++;
            }
        }

        // 表头样式设置
        var headerRow = sheet.Row(1);
        headerRow.Style.Font.Size = 12;
        headerRow.Style.Locked = true;
        headerRow.Style.Font.Color.SetColor(Color.DarkBlue);
        headerRow.Height = 30;
        headerRow.Style.VerticalAlignment = ExcelVerticalAlignment.Center;
        sheet.Cells.AutoFitColumns();
        
        package.SaveAs(stream);
    }

    stream.Position = 0;
    return stream;
}

额外优化建议 #

• 增加空值判断：比如clrType为空时直接返回null，避免后续代码出现空引用异常；attr为空时跳过处理，防止因属性标记缺失导致报错。
• 避免使用内部类型：永远不要依赖EF Core等框架的内部类（命名空间包含Internal的类型），这些类型属于实现细节，版本更新时可能会被修改或移除，导致代码兼容性问题。

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