Swagger显示没有参数到具有参数的控制器操作

Question

Swagger不在UI和JSON中显示参数，即使我的方法有参数，当我添加[FromBody]标记
Swagger UI无参数JSON文件无参数
操作方法时，尤其会发生这种情况：

    [HttpPost("Action")]
    public IActionResult Action([FromBody] string message)
    {
        return Ok(message);
    }

我使用全新的 Asp.net 核心3.1和2.2 Web应用程序与API模板来测试这一点，我完全按照文档配置
服务进行了配置：

services.AddMvc();

services.AddSwaggerGen(c =>
{
        c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
}

配置:< br >

 app.UseSwagger();

   app.UseSwaggerUI(c =>
 {
    c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
 });

当我使用[FromRoute]等其他属性时，它确实起作用

我还尝试了这样的物体:

    public class Message
{
    public int ID { get; set; }
    public string body { get; set; }
}

通过此操作:

 [HttpPost("Action")]
 public IActionResult Action([FromBody] Message message)
 {
    return Ok(message);
 }

相同的结果（没有参数），但它确实显示了模式

那么我做错了什么呢？如何像示例一样记录帖子参数

Answer 1

在使用 OpenAPI 3.0 时，您应该查看此代码示例：http://petstore.swagger.io:8080/

OpenAPI 3.0提供了< code>requestBody关键字来描述请求体。它将有效负载与< code >参数(如查询字符串和路径)区分开来。< code>requestBody更加灵活，因为它允许您使用不同的媒体类型，如JSON、XML、表单数据、纯文本等，并对不同的媒体类型使用不同的模式:

https://swagger.io/docs/specification/describing-request-body/

这是默认的UI，如果您单击“试用”，示例值将自动填充请求正文区域，以帮助创建测试请求正文。

Answer 2

我在 AspNetCore 5.0 上遇到了类似的问题，其中“复杂”类型将作为参数和输出类型被完全忽略。该问题是由于将输入/输出格式化程序切换到不同的JSON序列化程序（遗留代码，因为netonsoft在某些情况下速度很慢）引起的。新的虚张声势可以与系统.Text.Json或牛顿软件一起使用，但不能用于第三种解决方案。所以检查.AddMvcOptions（） 在配置服务中，如果对输入格式化程序或输出格式化程序执行了任何操作，则可能是罪魁祸首