ASP.NET Core Web API中User接口参数未显示问题求助

数据老陈

2026-6-29

问题分析与解决方案

核心问题原因

你的AddUser接口参数定义存在两个关键问题，导致Swagger无法正确识别并展示User对象的参数结构：

未指定请求体绑定特性：ASP.NET Core中，HttpPost接口的复杂类型参数需要通过[FromBody]标记明确告知框架从请求体中解析参数，否则框架无法正确识别参数来源，Swagger也无法生成对应的参数文档。
参数默认值为null：给复杂类型参数设置= null默认值会干扰Swagger的参数解析逻辑，使其无法识别该参数的具体结构。

修复步骤

修改控制器Action参数
将AddUser方法的参数调整为带[FromBody]特性且无默认值的形式：

[HttpPost]
[Route("AddUser")]
public IActionResult AddUser([FromBody] User u)
{
    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState);
    }

    _userManager.CreateUser(u);

    return Ok();
}

确保User类的可访问性
确认User类是public修饰的（若代码中未加修饰符，默认是internal，会导致API无法正确接收该类型参数）：

public class User
{
    [Key]
    public int Id { get; set; }
    [NotMapped]
    public Cart Cart { get; set; }
    [NotMapped]
    public List<Order> ListOfOrders { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }
    public string Password { get; set; }
}

验证Swagger配置（可选）
若修改后仍未显示参数，检查Swagger是否启用了XML注释支持（确保项目已生成XML文档文件，并在配置中引入）：

builder.Services.AddSwaggerGen(c =>
{
    var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
    var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
    c.IncludeXmlComments(xmlPath);
});