ASP.NET Core中创建Message时出现外键字段输入验证错误

实体类代码 #

namespace App.Models
{
    public class User 
    {
        public int Id { get; set; }
        public string Email { get; set; }
        public string Password { get; set; }
        public string Firstname { get; set; }

        public string Lastname { get; set; }

        public ICollection<Message> SentMessages { get; set; }
        public ICollection<Message> ReceivedMessages { get; set; }
    }
}

namespace App.Models
{
    public class Message 
    {
        public int Id { get; set; }
        public string Content { get; set; }
        public DateTime CreatedAt {get; set;}

        public int FromUserId { get; set;}
        public int ToUserId { get; set; }

        public User FromUser { get; set; }
        public User ToUser { get; set; }
    }
}

控制器代码 #

public async Task<IActionResult> CreateMessage(Message message)
{
    _context.Messages.Add(message);
    await _context.SaveChangesAsync();
    return Ok(message);
}

请求体 #

{
    "Content": "Hi, how are you",
    "FromUserId": 1,
    "ToUserId": 2
}

收到的验证错误 #

{
    "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
    "title": "One or more validation errors occurred.",
    "status": 400,
    "errors": {
        "ToUser": [
            "The ToUser field is required."
        ],
        "FromUser": [
            "The FromUser field is required."
        ]
    }
}

问题原因 #

在C# 8+的非空引用类型模式下，FromUser和ToUser作为引用类型（User），默认会被模型验证标记为必填项。但请求中只传了外键FromUserId和ToUserId，没有传递这两个导航属性的实例，因此触发验证错误。另外CreatedAt属性也存在同样问题——请求未传值，而DateTime默认不可空，后续也会触发验证失败。

解决方法 #

方法一：给导航属性和日期属性添加可空标记

修改Message实体类，将导航属性设为可空，同时给CreatedAt设置默认值：

public class Message 
{
    public int Id { get; set; }
    public string Content { get; set; }
    // 设置默认值为当前UTC时间
    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;

    public int FromUserId { get; set;}
    public int ToUserId { get; set; }

    // 添加可空标记
    public User? FromUser { get; set; }
    public User? ToUser { get; set; }
}

这样模型验证就不会要求必须传递FromUser和ToUser属性，EF Core会通过外键自动关联对应的用户实体。

方法二：使用DTO（数据传输对象）接收请求（推荐）

不要直接用数据库实体类接收前端请求，创建专门的DTO类只包含所需字段：

public class MessageCreateDto
{
    public string Content { get; set; }
    public int FromUserId { get; set; }
    public int ToUserId { get; set; }
}

修改控制器方法，将DTO映射到Message实体：

public async Task<IActionResult> CreateMessage(MessageCreateDto dto)
{
    var message = new Message
    {
        Content = dto.Content,
        FromUserId = dto.FromUserId,
        ToUserId = dto.ToUserId,
        CreatedAt = DateTime.UtcNow
    };

    _context.Messages.Add(message);
    await _context.SaveChangesAsync();
    return Ok(message);
}

这种方式更安全，避免暴露数据库实体内部结构，也能彻底规避导航属性的验证问题。

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