Fluent API创建外键失败：级联路径及聚集索引长度超限问题求解

错误原因与解决方法 #

1. 外键级联路径报错 #

你当前的Fluent API重复定义了CustomerOrder和CustomerOrderLine的关联关系，且没有绑定已声明的导航属性，导致EF生成重复外键约束，触发级联路径冲突。解决方法为统一关联配置，配对导航属性，按需调整级联删除行为。

2. 聚集索引长度超限报错 #

用作主键的OrderCode是字符串类型，EF Core默认给主键字符串映射为nvarchar(450)，单字符占2字节总长度900字节，而CustomerOrderLine的复合主键额外增加了4字节的int类型OrderLine，总长度904超出SQL Server聚集索引最大900字节的限制。解决方法为显式给OrderCode设置合理的业务长度即可。

调整后的Fluent API配置 #

modelBuilder.Entity<CustomerOrder>(e =>
{
    // 显式指定OrderCode的业务长度，可按需调整
    e.Property(p => p.OrderCode)
     .HasMaxLength(64)
     .IsRequired();
    e.HasKey(p => p.OrderCode);
    // 配对已声明的导航属性，避免重复配置
    e.HasMany(p => p.CustomerOrderLines)
     .WithOne()
     // 按需设置级联删除行为，无特殊需求用NoAction即可避免冲突
     .OnDelete(DeleteBehavior.NoAction);
    // HasPrecision第一个参数为总位数，第二个为小数位数，原配置漏传总位数会报错
    e.Property(p => p.Total)
     .HasPrecision(18, 2);
});

modelBuilder.Entity<CustomerOrderLine>(e =>
{
    // 和主表OrderCode长度保持一致
    e.Property(p => p.OrderCode)
     .HasMaxLength(64)
     .IsRequired();
    e.HasKey(p => new { p.OrderCode, p.OrderLine });
    // 已在CustomerOrder侧完成关联配置，此处无需重复配置，删除原重复配置行即可
});

补充说明 #

• 如果你需要保留级联删除，只要确认没有其他指向CustomerOrder的外键也设置了级联删除，就可以把DeleteBehavior.NoAction改回Cascade，不会再触发路径冲突报错。
• OrderCode的长度可根据实际业务的订单号规则调整，只要总长度（字符串长度*2 + 4字节int）不超过900即可，即使设为400位也完全符合要求。

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