添加Currency表后复合外键在DBeaver中显示异常的原因

我定义了DeliveryArea和DeliveryPrice实体，通过EF Core配置了DeliveryArea的复合主键，以及DeliveryPrice关联DeliveryArea的复合外键，生成数据库后外键显示正常。

之后添加了Currency实体，更新DeliveryPrice增加关联Currency的字段，并修改DbContext配置一对多关系。生成新数据库后，在DBeaver中发现连接DeliveryArea和DeliveryPrice的复合外键被拆分成两个。但将Currencies表改名为Foo后，该复合外键显示恢复正常。

进一步排查发现，此问题仅出现在DBeaver中，使用其他数据库查看工具（如DbSchema）查看同一数据库文件时无异常。请问这是什么原因？

初始实体与DbContext配置 #

实体类 #

internal class DeliveryArea
{
    public string Postcode { get; set; }
    public string State { get; set; }
    public string Country { get; set; }

    public ICollection<DeliveryPrice> HasDeliveryPrices { get; set; }
}

internal class DeliveryPrice
{
    public uint Id { get; set; }

    public DeliveryArea ForDeliveryArea { get; set; }
    public string DeliveryAreaPostcode { get; set; }
    public string DeliveryAreaState { get; set; }
    public string DeliveryAreaCountry { get; set; }
}

DbContext配置 #

internal class MyDbContext : DbContext
{
    public DbSet<DeliveryArea> DeliveryAreas { get; set; }
    public DbSet<DeliveryPrice> DeliveryPrices { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlite(@"Data Source=Test.EFCore.db;");
    }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        #region DeliveryArea.
        {
            var entity = modelBuilder.Entity<DeliveryArea>();
            entity.Property(i => i.Postcode).HasColumnType("TEXT COLLATE NOCASE");
            entity.Property(i => i.State).HasColumnType("TEXT COLLATE NOCASE");
            entity.Property(i => i.Country).HasColumnType("TEXT COLLATE NOCASE");
            entity.HasKey(nameof(DeliveryArea.Postcode), nameof(DeliveryArea.State), nameof(DeliveryArea.Country));
        }
        #endregion

        #region DeliveryPrice.
        {
            var entity = modelBuilder.Entity<DeliveryPrice>();
            entity.HasOne(left => left.ForDeliveryArea)
                .WithMany(right => right.HasDeliveryPrices)
                .HasForeignKey(left => new { left.DeliveryAreaPostcode, left.DeliveryAreaState, left.DeliveryAreaCountry });
        }
        #endregion
    }
}

添加Currency后的实体与DbContext配置 #

Currency实体类 #

internal class Currency
{
    public uint Id { get; set; }
    public ICollection<DeliveryPrice> ForDeliveryPrices { get; set; }
}

更新后的DeliveryPrice实体类 #

internal class DeliveryPrice
{
    public uint Id { get; set; }

    public Currency HasCurrency { get; set; }
    public uint HasCurrencyId { get; set; }

    public DeliveryArea ForDeliveryArea { get; set; }
    public string DeliveryAreaPostcode { get; set; }
    public string DeliveryAreaState { get; set; }
    public string DeliveryAreaCountry { get; set; }
}

更新后的DbContext配置 #

internal class MyDbContext : DbContext
{
    public DbSet<Currency> Currencies { get; set; }

    // 原有代码保留...

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        #region Currency.
        {
            var entity = modelBuilder.Entity<Currency>();
            entity.HasMany(left => left.ForDeliveryPrices)
                .WithOne(right => right.HasCurrency)
                .HasForeignKey(right => right.HasCurrencyId);
        }
        #endregion
        
        // 原有代码保留...
    }
}

原因分析 #

这是DBeaver的元数据解析bug，具体细节如下：

1. SQLite数据库本身的复合外键结构是正常的，其他工具能正确识别，说明EF Core生成的数据库没有问题。
2. 新增Currencies表后，DBeaver在解析DeliveryPrice表的外键时，其内部的字段匹配逻辑出现异常，把原本的单个复合外键拆分成了多个独立外键。
3. 将表名改为Foo后，避开了触发这个bug的条件，所以DBeaver能正常显示复合外键。

这类问题属于数据库客户端工具的解析逻辑缺陷，和EF Core的配置无关，可通过临时修改表名或等待DBeaver官方修复bug解决。

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