linq2db 5.4.1（PostgreSQL）视图关联无法自动填充求助

问题描述 #

在PostgreSQL环境下使用linq2db 5.4.1，通过脚手架生成了两个视图的实体类：

EsProgramguidedayschedule视图实体：

[Table("es_programguidedayschedule", IsView = true)]
public partial class EsProgramguidedayschedule
{
    [Column("pk_es_programguidedayschedule_id", SkipOnInsert = true, SkipOnUpdate = true)] public long? PkEsProgramguidedayscheduleId { get; set; } // bigint
    [Column("channel_fk_esp_channel_lot_id", SkipOnInsert = true, SkipOnUpdate = true)] public long? ChannelFkEspChannelLotId { get; set; } // bigint
    [Column("ds_date", SkipOnInsert = true, SkipOnUpdate = true)] public DateTime? DsDate { get; set; } // date
}

EspChannel视图实体：

[Table("esp_channel", IsView = true)]
public partial class EspChannel
{
    [Column("pk_esp_channel_lot_id", SkipOnInsert = true, SkipOnUpdate = true)] public long?   PkEspChannelLotId { get; set; } // bigint
    [Column("name"                 , SkipOnInsert = true, SkipOnUpdate = true)] public string? Name              { get; set; } // character varying(255)
    [Column("usercode"             , SkipOnInsert = true, SkipOnUpdate = true)] public string? Usercode          { get; set; } // character varying(255)
}

通过显式LINQ左连接可以正常获取关联数据：

var results2 =
    (from s in db.EsProgramguidedayschedules
    join c in db.EspChannels on s.ChannelFkEspChannelLotId equals c.PkEspChannelLotId into cmaybe
    from c in cmaybe.DefaultIfEmpty()
    select 
        new { s, c }).ToArray();

但通过分部类添加[Association]特性配置导航属性后，Channel属性始终无法自动填充：

public partial class EsProgramguidedayschedule
{
    [Association(ThisKey = nameof(ChannelFkEspChannelLotId), OtherKey = nameof(Channel.PkEspChannelLotId))]
    public EspChannel Channel { get; set; }
}

注：底层视图无内置外键关联。

原因分析 #

1. Association配置错误：原代码中OtherKey使用了nameof(Channel.PkEspChannelLotId)，但Channel是当前类的属性名，而非关联实体类名，应该指向EspChannel类的主键属性。
2. linq2db不会自动加载导航属性：即使配置了Association，linq2db默认不会自动触发关联查询，需要显式指定加载方式（如Include）或在投影中引用导航属性。
3. 视图无外键导致自动推断失效：由于底层是视图没有外键约束，linq2db无法自动识别关联关系，必须完全依赖Association特性的正确配置。

解决方案 #

1. 修正Association配置 #

将OtherKey改为正确的实体类属性引用，并添加CanBeNull=true（对应左连接场景），同时将属性改为可空类型：

public partial class EsProgramguidedayschedule
{
    [Association(ThisKey = nameof(ChannelFkEspChannelLotId), 
                 OtherKey = nameof(EspChannel.PkEspChannelLotId),
                 CanBeNull = true)]
    public EspChannel? Channel { get; set; }
}

2. 显式加载关联数据 #

配置正确后，需要通过以下方式触发关联加载：

• 使用Include方法：

var results = db.EsProgramguidedayschedules
                .Include(s => s.Channel)
                .ToArray();

• 投影时直接引用导航属性：
  linq2db会自动将导航属性转换为关联查询：

var results = db.EsProgramguidedayschedules
                .Select(s => new { s, s.Channel })
                .ToArray();

3. 可复用的关联查询方案 #

可以通过扩展方法封装关联逻辑，实现代码复用与组合：

方案一：封装投影DTO

// 定义复用的DTO类
public class ScheduleWithChannel
{
    public EsProgramguidedayschedule Schedule { get; set; }
    public EspChannel? Channel { get; set; }
}

// 扩展方法封装查询逻辑
public static class ScheduleQueryExtensions
{
    public static IQueryable<ScheduleWithChannel> WithChannel(this IQueryable<EsProgramguidedayschedule> query)
    {
        return query.Select(s => new ScheduleWithChannel
        {
            Schedule = s,
            Channel = s.Channel
        });
    }
}

使用方式：

var results = db.EsProgramguidedayschedules.WithChannel().ToArray();

方案二：封装Include逻辑

public static class ScheduleQueryExtensions
{
    public static IQueryable<EsProgramguidedayschedule> IncludeChannel(this IQueryable<EsProgramguidedayschedule> query)
    {
        return query.Include(s => s.Channel);
    }
}

使用方式：

var results = db.EsProgramguidedayschedules.IncludeChannel().ToArray();

内容的提问来源于stack exchange，提问作者MrD at KookerellaLtd