ASP.NET Core WebAPI POST提交报Friend导航属性必填校验错误

DevOps 小满

2026-8-30

问题根因

ASP.NET Core 内置的模型绑定校验机制，默认会将所有非可空引用类型自动标记为必填项。你在VideoCollection实体中定义的Friend导航属性是普通引用类型，没有声明为可空，即使前端已经传递了外键字段FriendId，框架在入参校验阶段依然会检查Friend属性是否有值，因此触发The Friend field is required的校验错误。
你在OnModelCreating里配置的.IsRequired()是设置数据库层面的外键FriendId非空约束，和这次的入参校验错误没有关系，这部分配置不需要修改。
另外你提交的请求体中外键字段写为全小写friendid，虽然ASP.NET Core默认的Json序列化支持大小写不敏感绑定，但建议和后端属性命名FriendId保持一致，避免出现隐式绑定失败问题。

修复方案

你可以根据自己的项目场景选以下任意一种方案：

方案1：标记导航属性为可空（改动最小）
直接修改VideoCollection实体类，给导航属性加可空标记，告诉框架这个字段不需要强制非空校验：

public class VideoCollection
{
    public int Id { get; set; }
    // 其他业务属性省略
    public int FriendId { get; set; }
    // 加?标记为可空引用类型
    public virtual Friend? Friend { get; set; }
}

修改后只要传入合法的FriendId外键值，不需要传递Friend对象就能正常通过校验、写入数据库。

方案2：全局关闭隐式必填校验
如果你不想修改实体定义，可以在Program.cs中配置Api行为选项，关闭非可空引用类型自动加必填校验的规则：

builder.Services.AddControllers()
    .ConfigureApiBehaviorOptions(options =>
    {
        options.SuppressImplicitRequiredAttributeForNonNullableReferenceTypes = true;
    });

注意这个配置是全局生效的，所有接口的非可空引用类型都不会自动触发必填校验，如果项目大部分接口需要默认的入参必填校验，不推荐用这个方案。

方案3：使用独立请求DTO（生产环境推荐）
不要直接将数据库实体作为接口入参，单独定义专门用来接收创建请求的DTO类，只保留前端需要传递的字段，从根源上避免导航属性参与模型校验，同时还能防止字段过传的安全问题：

public class CreateVideoCollectionRequest
{
    public string Movietitle { get; set; }
    public string Yearreleased { get; set; }
    public decimal Rating { get; set; }
    public string Subject { get; set; }
    public decimal Length { get; set; }
    public string Note { get; set; }
    public int FriendId { get; set; }
}

然后修改控制器Action，接收这个DTO类型，手动映射成VideoCollection实体后再保存到数据库即可。

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