ASP.NET Core OData服务中可为空外键引发运行时错误

问题根源
数据库中存在EquipmentCatalogueRef字段为null的记录，但OData模型将该属性标记为Nullable=False（不可为空），导致OData序列化时校验失败，抛出异常。

解决方案 #

分两种场景处理：

场景1：外键确实允许为空 #

如果业务上允许EquipmentCatalogueRef为null，需要确保OData模型将该属性标记为可空，有两种方式：

• 方式A：显式配置OData模型
  在Program.cs的OData模型构建代码中，为Equipment实体的该属性添加可空配置：

builder.EntityType<Equipment>()
       .Property(e => e.EquipmentCatalogueRef)
       .IsNullable();

• 方式B：确保EF实体属性定义正确
  检查你的Equipment实体类，确认外键属性定义为可空值类型：

public int? EquipmentCatalogueRef { get; set; } // 注意是int?而非int

OData会自动识别EF实体的可空性，无需额外配置。

场景2：外键不允许为空 #

如果业务规则要求EquipmentCatalogueRef不能为null，需要清理数据或过滤查询结果：

• 清理数据库：为所有EquipmentCatalogueRef为null的记录补全有效值；
• 过滤查询结果：修改控制器的Get方法，排除null值记录：

[HttpGet]
[EnableQuery]
[Authorize(Roles = "System,Administrator")]
public IQueryable<Equipment> Get()
{
    return _sqlServerContext.Equipments
        .Where(e => e.EquipmentCatalogueRef != null)
        .AsQueryable();
}

针对测试项目的修复 #

你提供的测试项目中，访问http://localhost:5147/odata/user?$expand=FileRefNavigation出现的问题，本质和上述一致：

1. 检查User实体中对应FileRefNavigation的外键属性（如FileRefId）是否为可空类型；
2. 确认OData模型中该外键属性是否被标记为可空；
3. 若业务允许为空，按场景1修复；若不允许，清理数据库null记录或过滤查询。

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