使用Entity Framework更新数据库失败：外键约束错误求助

原因分析 #

1. 外键约束冲突：给Tours表添加TravelCountryId列时设置了defaultValue: 0，但此时TravelCountries表刚创建、是空的，没有Id=0的记录。MySQL的外键约束要求子表的外键值必须在主表中存在，因此添加外键时触发约束失败。
2. 实体类定义矛盾：Tour类里的TravelCountry字段标记了[Required]，但又声明为可空类型TravelCountry?，这会让EF生成非空外键，但类型定义的可空性和必填属性冲突，也会干扰迁移逻辑。

解决步骤 #

步骤1：调整迁移代码，保证主表有匹配数据 #

修改迁移的执行顺序，先创建TravelCountries表并插入一条默认记录，再给Tours表设置合法的外键值，最后添加外键：

migrationBuilder.DropColumn(
    name: "TravelCountry",
    table: "Tours");

// 先创建TravelCountries表
migrationBuilder.CreateTable(
    name: "TravelCountries",
    columns: table => new
    {
        Id = table.Column<int>(type: "int", nullable: false)
            .Annotation("MySql:ValueGenerationStrategy", MySqlValueGenerationStrategy.IdentityColumn),
        Name = table.Column<string>(type: "longtext", nullable: false)
            .Annotation("MySql:CharSet", "utf8mb4")
    },
    constraints: table =>
    {
        table.PrimaryKey("PK_TravelCountries", x => x.Id);
    })
    .Annotation("MySql:CharSet", "utf8mb4");

// 插入一条默认国家记录（可根据业务修改名称）
migrationBuilder.Sql("INSERT INTO TravelCountries (Name) VALUES ('默认国家');");

// 添加TravelCountryId列，用刚插入记录的Id作为默认值（IdentityColumn默认从1开始自增）
migrationBuilder.AddColumn<int>(
    name: "TravelCountryId",
    table: "Tours",
    type: "int",
    nullable: false,
    defaultValue: 1);

migrationBuilder.CreateIndex(
    name: "IX_Tours_TravelCountryId",
    table: "Tours",
    column: "TravelCountryId");

migrationBuilder.AddForeignKey(
    name: "FK_Tours_TravelCountries_TravelCountryId",
    table: "Tours",
    column: "TravelCountryId",
    principalTable: "TravelCountries",
    principalColumn: "Id",
    onDelete: ReferentialAction.Cascade);

步骤2：修正实体类的矛盾定义 #

如果业务要求Tour必须关联TravelCountry，去掉可空标记：

public class Tour
{
    [Key]
    public int Id { get; set; }

    [Required]
    public TravelCountry TravelCountry { get; set; } // 移除?
}

如果允许Tour暂时不关联TravelCountry，则去掉[Required]属性：

public class Tour
{
    [Key]
    public int Id { get; set; }

    public TravelCountry? TravelCountry { get; set; } // 移除[Required]
}

步骤3：执行迁移并处理现有数据 #

运行Update-Database（或dotnet ef database update）执行迁移，之后可根据业务需求修改Tours表中对应的TravelCountryId，替换为实际的国家记录Id。

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