如何限制C# POST请求中实体类需填充的字段

明确结论：你完全可以在请求体里移除不需要的字段，不用强制传null。报错的核心原因是后端序列化/模型绑定组件（比如ASP.NET Core默认的System.Text.Json）在处理多构造函数的类时，无法自动选择合适的构造函数创建实例，进而抛出Could not create an instance错误。

下面是具体解决思路：

1. 指定序列化器优先使用的构造函数 #

给你希望序列化器调用的构造函数加特性标记，明确告诉组件该用哪个构造函数实例化对象：

• 若使用System.Text.Json，添加[JsonConstructor]特性：

public class Person
{
    public Guid Id { get; set; }
    public string Name { get; set; }
    public string LastName { get; set; }
    public DateTime? Death { get; set; }
    public List<Kid> Kids { get; set; }

    // 标记此构造函数为序列化器专用
    [JsonConstructor]
    public Person(Guid id, string name, string lastName)
    {
        Id = id;
        Name = name;
        LastName = lastName;
        // 可选字段可在这里初始化默认值，比如 Kids = new List<Kid>()
    }

    // 其他构造函数仅供业务逻辑内部使用
    public Person(Guid id, string name, string lastName, DateTime death, List<Kid> kids)
    {
        Id = id;
        Name = name;
        LastName = lastName;
        Death = death;
        Kids = kids;
    }
}

此时序列化器会优先调用带[JsonConstructor]的构造函数，请求体只需传递该构造函数参数对应的字段，不需要的字段（比如Death、Kids）可完全省略，实体类属性会保持默认值（或你在构造函数里初始化的值）。

• 若使用Newtonsoft.Json，同样可以用[JsonConstructor]特性标记目标构造函数。

2. 调整实体类设计，避免多构造函数（推荐） #

如果业务允许，尽量采用无参构造函数+属性初始化的方式定义实体类，这是最省心的方案，序列化器能轻松实例化对象，自动绑定请求体字段，未传递的字段会保持默认值：

public class Person
{
    public Guid Id { get; set; }
    public string Name { get; set; }
    public string LastName { get; set; }
    public DateTime? Death { get; set; }
    public List<Kid> Kids { get; set; } = new List<Kid>(); // 初始化空列表，避免null

    // 无参构造函数，供序列化器使用
    public Person()
    {
    }

    // 业务逻辑专用的创建方法，内部调用无参构造函数赋值
    public static Person CreateWithFullInfo(Guid id, string name, string lastName, DateTime death, List<Kid> kids)
    {
        return new Person
        {
            Id = id,
            Name = name,
            LastName = lastName,
            Death = death,
            Kids = kids
        };
    }
}

这种方式下，前端请求只需传递需要的字段（比如Id、Name、LastName），不需要的字段完全不用传，后端会自动创建实例并忽略未传递的字段。

3. 优化Swagger显示，隐藏非必填字段 #

如果某些字段在特定接口中不需要，可以用特性标记让Swagger不再要求填写这些字段：

public class Person
{
    public Guid Id { get; set; }
    public string Name { get; set; }
    public string LastName { get; set; }

    // 标记该字段在Swagger中隐藏
    [ApiExplorerSettings(IgnoreApi = true)]
    public DateTime? Death { get; set; }

    [ApiExplorerSettings(IgnoreApi = true)]
    public List<Kid> Kids { get; set; }
}

注意：这只是优化前端请求体验，核心还是要先解决序列化器的实例化问题，否则即使Swagger不显示，不传字段仍会报错。

总结 #

• 不需要强制传null，完全可以移除不需要的字段；
• 优先通过标记[JsonConstructor]或改用无参构造函数的方式，解决序列化器无法实例化的问题；
• 配合Swagger字段隐藏，进一步优化前端请求体验。

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