Swagger未显示List对象及API无法绑定数据问题求助

核心原因：接口参数绑定冲突 #

你的API方法存在参数绑定逻辑错误：

• ASP.NET Core规定，单个POST请求只能有一个标记为[FromBody]的参数，因为请求体内容只能被读取一次。
• 未指定绑定来源的Guid id参数，框架会默认尝试从请求体中解析它，这会直接干扰CreateProductOrderInputModel request的绑定过程，导致整个模型（包括item和Items）无法正确接收JSON数据，同时Swagger也无法正常解析并展示模型的完整结构。

次要影响因素（非核心） #

你在模型中给item和Items都初始化了默认实例：

public OrderItemInputModel item { get; set; } = new OrderItemInputModel();
public List<OrderItemInputModel> Items { get; set; } = new List<OrderItemInputModel>();

这可能让Swagger对属性的必填性/类型识别产生混淆，但这不是导致赋值失败和Swagger不显示列表的根本原因。

解决方案 #

1. 修正参数绑定来源：给Guid id明确指定绑定方式，根据实际业务场景选择：

   • 如果id是URL路由参数（比如接口路径为OrderConsumables/{id}）：

     [HttpPost("OrderConsumables/{id}")]       
     public async Task<IActionResult> ControllerMethod([FromBody] CreateProductOrderInputModel request, [FromRoute] Guid id)
     

   • 如果id是URL查询参数（比如接口路径为OrderConsumables?id=xxx）：

     [HttpPost("OrderConsumables")]       
     public async Task<IActionResult> ControllerMethod([FromBody] CreateProductOrderInputModel request, [FromQuery] Guid id)
     

2. 可选优化：如果业务上不需要默认实例，可以移除模型中item和Items的初始化代码，让Swagger更清晰地展示模型结构：

   public OrderItemInputModel item { get; set; }
   public List<OrderItemInputModel> Items { get; set; }
   

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