Entity Framework Core + Npgsql迁移失败：外键约束已存在

这个问题的核心原因是PostgreSQL标识符长度限制，结合EF Core 2.0.1 + Npgsql 2.0.1的默认约束名称生成逻辑导致的冲突：

1. PostgreSQL默认对标识符（如表名、约束名等）的最大长度限制为63个字符，超过部分会被自动截断。
2. 你的PiezasStockExterno表有两个外键都指向ContenedoresDocumentos表，EF Core自动生成的约束名称分别是：
   • FK_PiezasStockExterno_ContenedoresDocumentos_IdContenedorDocumentosPieza
   • FK_PiezasStockExterno_ContenedoresDocumentos_IdContenedorDocumentosVehiculo
3. 这两个名称的长度都远超过63字符，被PostgreSQL截断后会变成完全相同的名称（比如错误信息里的FK_PiezasStockExterno_ContenedoresDocumentos_IdContenedorDocume），所以当创建第二个约束时，数据库会提示该约束已存在。

另外，你的模型配置里还有一个潜在的小问题：ContenedorDocumentos类中的所有集合导航属性都使用了[InverseProperty("ContenedorDocumentos")]，但PiezaStockExterno的两个导航属性并没有在ContenedorDocumentos中配置对应的反向导航，不过这不是本次错误的直接原因，只是后续需要注意的配置细节。

针对这个问题，你可以通过以下两种方式解决：

方式1：手动指定更短的约束名称 #

在生成的InitialMigration.cs文件中，手动修改两个外键约束的名称，让它们的长度不超过63字符且唯一：

migrationBuilder.CreateTable(
    name: "PiezasStockExterno",
    schema: "public",
    columns: table => new {
        Id = table.Column<int>(nullable: false)
            .Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.SerialColumn),
        IdContenedorDocumentosPieza = table.Column<int>(nullable: true),
        IdContenedorDocumentosVehiculo = table.Column<int>(nullable: true)
    },
    constraints: table => {
        table.PrimaryKey("PK_PiezasStockExterno", x => x.Id);
        // 自定义短名称，避免截断冲突
        table.ForeignKey(
            name: "FK_PiezaStockExt_ContDoc_Pieza",
            column: x => x.IdContenedorDocumentosPieza,
            principalSchema: "public",
            principalTable: "ContenedoresDocumentos",
            principalColumn: "Id",
            onDelete: ReferentialAction.Restrict);
        // 自定义另一个唯一短名称
        table.ForeignKey(
            name: "FK_PiezaStockExt_ContDoc_Vehiculo",
            column: x => x.IdContenedorDocumentosVehiculo,
            principalSchema: "public",
            principalTable: "ContenedoresDocumentos",
            principalColumn: "Id",
            onDelete: ReferentialAction.Restrict);
    });

修改后重新执行dotnet ef database update即可。

方式2：升级EF Core和Npgsql版本 #

EF Core和Npgsql的后续版本（比如EF Core 2.1+、Npgsql 2.1+）已经优化了约束名称的生成逻辑，会自动处理长名称的截断问题，避免重复。如果你可以升级依赖，这是更长久的解决方案：

• 升级Microsoft.EntityFrameworkCore到2.1或更高版本
• 升级Npgsql.EntityFrameworkCore.PostgreSQL到对应匹配的版本

额外的模型配置建议 #

为了让EF Core更清晰地识别导航关系，建议在ContenedorDocumentos类中添加对应PiezaStockExterno的反向导航属性，并配置InverseProperty：

[Table("ContenedoresDocumentos", Schema = "public")]
public class ContenedorDocumentos {
    [Key]
    public int Id { get; set; }
    [InverseProperty("ContenedorDocumentos")]
    public IList<Imagen> Imagenes { get; set; }
    [InverseProperty("ContenedorDocumentos")]
    public IList<Foto> Fotos { get; set; }
    [InverseProperty("ContenedorDocumentos")]
    public IList<Documento> Documentos { get; set; }
    [InverseProperty("ContenedorDocumentos")]
    public IList<Video> Videos { get; set; }
    
    // 添加两个反向导航，明确对应关系
    [InverseProperty("ContenedorDocumentosPieza")]
    public IList<PiezaStockExterno> PiezasStockExternoPorPieza { get; set; }
    [InverseProperty("ContenedorDocumentosVehiculo")]
    public IList<PiezaStockExterno> PiezasStockExternoPorVehiculo { get; set; }
}

这样可以让EF Core更准确地生成关系，避免潜在的配置误解。

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