EF Migration无法创建新表，求技术解决方案

针对你碰到的新增BuilderPreferences表迁移失败的情况，按以下步骤排查：

1. 先确认DbContext里注册了这个实体 #

EF只认DbContext中声明了DbSet<>或者在OnModelCreating里配置过的实体，这是新手最容易漏的：

• 在项目的DbContext类里加对应的DbSet：

  public DbSet<BuilderPreferences> BuilderPreferences { get; set; }
  

• 如果用Fluent API配置，要在OnModelCreating方法里加上：

  modelBuilder.Entity<BuilderPreferences>();
  

2. 检查BaseEntity的主键配置 #

EF要求每个实体必须有主键，确认你的BaseEntity有没有正确定义主键：

• 比如BaseEntity是不是包含public long Id { get; set; }这类属性，或者标注了[Key]注解？要是主键缺失，EF根本没法识别实体结构。

3. 执行迁移命令时指定正确的DbContext #

如果项目里有多个DbContext，必须明确指定目标上下文，不然可能用错了上下文导致实体没被识别：

• Package Manager Console命令：

  Add-Migration AddBuilderPreferences -Context 你的DbContext类名
  Update-Database -Context 你的DbContext类名
  

• .NET CLI命令：

  dotnet ef migrations add AddBuilderPreferences --context 你的DbContext类名
  dotnet ef database update --context 你的DbContext类名
  

4. 开详细日志找隐藏错误 #

终端看不到错误的话，开启详细日志能看到藏起来的异常：

• .NET CLI加-v参数看完整输出：

  dotnet ef migrations add AddBuilderPreferences -v
  

• Package Manager Console去输出面板看完整日志，很多时候错误信息会被折叠在角落。

5. 排查手动修改迁移文件的问题 #

如果你手动改了迁移的Up/Down方法或者快照，大概率是改出了语法错误或配置冲突：

• 检查Up方法里创建表的语句，比如有没有重复列、数据类型不匹配：

  // 参考正确的建表语句
  migrationBuilder.CreateTable(
      name: "builder_preferences",
      columns: table => new
      {
          Id = table.Column<long>(type: "bigint", nullable: false)
              .Annotation("SqlServer:Identity", "1, 1"),
          BuilderId = table.Column<long>(type: "bigint", nullable: false),
          GroupId = table.Column<long>(type: "bigint", nullable: false),
          OrganizationId = table.Column<long>(type: "bigint", nullable: false)
          // BaseEntity里的其他列也要加进来
      },
      constraints: table =>
      {
          table.PrimaryKey("PK_builder_preferences", x => x.Id);
      });
  

• 快照文件是EF跟踪模型变化的核心，要确保里面BuilderPreferences的配置和实体类完全一致，手动改很容易搞乱。

6. 检查实体注解和命名约定的冲突 #

你的实体用了[Table("builder_preferences")]注解，确认其他表也用了全小写的命名规则，另外注意属性拼写（比如你代码里GroupId后面少了空格，虽然编译能过但尽量规范）。

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