EF Core Db First项目：统一实体主键属性名实现Generic Repository

一、纠正认知：数据注解/Fluent API在反向生成模型中同样有效 #

你提到的“数据注解和Fluent API仅适用于Code First模式”是误解——通过scaffold反向生成的模型，本质上仍是EF的实体模型，完全可以通过添加[Column]注解或Fluent API配置，实现模型属性名与数据库列名的映射，不会改变现有数据库结构。

二、批量实现统一主键命名的可靠方法 #

方法1：修改Scaffold模板（推荐，一劳永逸） #

如果还未最终确定模型，或者可以重新生成模型，修改scaffold的模板可以让生成的模型自动将主键命名为UniqueId并添加映射注解，无需手动修改。

以EF Core为例：

1. 导出模板到项目
   执行以下命令，将scaffold的类模板导出到项目的Templates目录：

   dotnet ef db scaffold "你的连接字符串" Microsoft.EntityFrameworkCore.SqlServer --output-dir Models --template Templates/Class.cshtml --force
   

   若目录不存在，先创建Templates文件夹。

2. 修改模板逻辑
   打开导出的Class.cshtml模板，找到生成属性的循环代码，修改主键属性的生成逻辑：

   @foreach (var property in Entity.Properties)
   {
       var isPrimaryKey = property.IsPrimaryKey;
       var propertyName = isPrimaryKey ? "UniqueId" : property.Name;
       var columnName = isPrimaryKey ? $"[Column(\"{property.ColumnName}\")]" : "";
   
       @if (!string.IsNullOrEmpty(columnName))
       {
           @:    @columnName
       }
       @:    public @property.ClrType @propertyName { get; set; }
       @:
   }
   

   这段代码会将所有主键属性命名为UniqueId，并自动添加[Column("原数据库列名")]注解，非主键属性保持原有名称。

3. 重新生成模型
   再次执行scaffold命令，生成的模型就会自动带有统一的UniqueId主键属性和正确的列映射。

方法2：批量修改已生成的模型代码 #

如果已经生成了模型且不想重新scaffold，可以用Roslyn编写一个小工具批量修改代码：

using Microsoft.CodeAnalysis;
using Microsoft.CodeAnalysis.CSharp;
using Microsoft.CodeAnalysis.CSharp.Syntax;
using System.IO;
using System.Linq;

class Program
{
    static void Main(string[] args)
    {
        // 模型文件所在目录
        var modelDir = "./Models";
        foreach (var file in Directory.EnumerateFiles(modelDir, "*.cs"))
        {
            var code = File.ReadAllText(file);
            var tree = CSharpSyntaxTree.ParseText(code);
            var root = tree.GetRoot();

            // 获取类声明
            var classDecl = root.DescendantNodes().OfType<ClassDeclarationSyntax>().FirstOrDefault();
            if (classDecl == null) continue;

            // 找到主键属性（通过[Key]特性识别）
            var primaryProperty = classDecl.Members
                .OfType<PropertyDeclarationSyntax>()
                .FirstOrDefault(p => p.AttributeLists.Any(al => 
                    al.Attributes.Any(a => a.Name.ToString() == "Key")));
            if (primaryProperty == null) continue;

            // 1. 修改属性名为UniqueId
            var newProperty = primaryProperty.WithIdentifier(SyntaxFactory.Identifier("UniqueId"));

            // 2. 添加[Column("原列名")]注解（原列名默认与原属性名一致，若不一致需调整）
            var originalColumnName = primaryProperty.Identifier.Text;
            var columnAttr = SyntaxFactory.Attribute(SyntaxFactory.ParseName("Column"))
                .WithArgumentList(SyntaxFactory.AttributeArgumentList(
                    SyntaxFactory.SingletonSeparatedList(
                        SyntaxFactory.AttributeArgument(
                            SyntaxFactory.LiteralExpression(SyntaxKind.StringLiteralExpression, 
                                SyntaxFactory.Literal(originalColumnName))))));

            // 合并原有特性列表
            var newAttrLists = newProperty.AttributeLists.Add(
                SyntaxFactory.AttributeList(SyntaxFactory.SingletonSeparatedList(columnAttr)));
            var newPropertyWithAttr = newProperty.WithAttributeLists(newAttrLists);

            // 替换原有属性，生成新代码
            var newRoot = root.ReplaceNode(primaryProperty, newPropertyWithAttr);
            File.WriteAllText(file, newRoot.ToFullString());
        }
    }
}

运行这个工具后，所有模型的主键属性会被重命名为UniqueId，并自动添加列映射注解。

方法3：批量Fluent API配置（无需修改模型属性名，适配通用仓库） #

如果不想修改模型属性名，但仍要实现通用仓库的CRUD，可以通过EF的元数据批量获取主键，在OnModelCreating中统一配置，同时让通用仓库通过反射获取主键：

public class AppDbContext : DbContext
{
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 遍历所有实体，配置主键映射（如果需要调整列名）
        foreach (var entityType in modelBuilder.Model.GetEntityTypes())
        {
            var primaryKey = entityType.FindPrimaryKey();
            if (primaryKey != null && primaryKey.Properties.Count == 1)
            {
                var pkProperty = primaryKey.Properties[0];
                // 这里可以配置列名，若不需要改列名则无需操作
                // pkProperty.SetColumnName(pkProperty.Name);
            }
        }
    }
}

// 通用仓库示例，通过反射获取主键
public class GenericRepository<T> where T : class
{
    private readonly DbContext _context;
    private readonly DbSet<T> _dbSet;
    private readonly PropertyInfo _primaryKeyProperty;

    public GenericRepository(DbContext context)
    {
        _context = context;
        _dbSet = context.Set<T>();
        // 获取主键属性
        var entityType = context.Model.FindEntityType(typeof(T));
        var primaryKey = entityType.FindPrimaryKey();
        _primaryKeyProperty = typeof(T).GetProperty(primaryKey.Properties[0].Name);
    }

    public T GetById(object id)
    {
        return _dbSet.Find(id);
    }

    // 其他CRUD方法...
}

不过这个方法没有修改属性名，只是绕开了属性名不一致的问题，如果你必须统一属性名，前两种方法更合适。

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