Entity Framework Core连接Oracle：导航属性可空性失效问题

数据老陈

2026-7-1

问题诊断

你遇到的是EF Core结合Oracle数据库时，可空主键关联的兼容性问题：

Base实体的BaseEntityId是可空int类型（int?），被配置为关联的主键（HasPrincipalKey）
AddressLink的EntityId是非空int，作为外键关联到BaseEntityId
当Base的BaseEntityId为NULL时，Oracle驱动在构建关联关系时，会尝试将NULL转换为非空int，触发InvalidCastException，而非返回预期的空集合。

解决方案

1. 显式标记关联为可选

在上下文的关联配置中，明确告知EF Core该关联是可选的（对应主键字段的可空性）：

modelBuilder.Entity<Base>()
    .HasMany(b => b.AddressLinks)
    .WithOne(l => l.Base)
    .HasForeignKey(l => l.EntityId)
    .HasPrincipalKey(b => b.BaseEntityId)
    .IsRequired(false); // 显式声明关联允许无匹配

2. 调整导航属性类型为`ICollection<T>`

EF Core对ICollection<T>的延迟加载和空集合处理支持更稳定：

public virtual ICollection<AddressLink>? AddressLinks { get; set; } = new List<AddressLink>();

3. 查询时手动拆分处理

如果上述配置无效，可以在查询时分开处理两类记录：

// 处理有BaseEntityId的记录，正常加载导航属性
var validBases = await context.Bases
    .Where(b => b.BaseEntityId != null)
    .Include(b => b.AddressLinks)
    .ToListAsync();

// 处理BaseEntityId为NULL的记录，导航属性保持初始化的空集合
var nullIdBases = await context.Bases
    .Where(b => b.BaseEntityId == null)
    .ToListAsync();