ASP.NET Core下Swagger UI调用GET接口报错：GET/HEAD请求不能携带body

错误原因 #

• HTTP规范明确不允许GET/HEAD请求携带请求体，你遇到的报错是Swagger调用接口时给GET请求附加了请求体导致的
• 根因是你的GET接口未显式声明参数绑定来源，Swagger会将自定义枚举TicketingModes默认识别为请求体参数，生成的请求规则不符合HTTP规范

修复方法 #

给GET接口的所有参数添加[FromQuery]特性，强制框架从URL查询字符串读取参数，修改后的代码如下：

[Route("office/[controller]")]
public class AttendeeController : BoxOfficeControllerBase
{
    [HttpGet]
    public DataActionResponse<IList<AttendeeDetailModel>> GetAll([FromQuery] TicketingModes eventType, [FromQuery] int? showId = null)
    {
        // 原有业务逻辑保持不变
        return null;
    }
}

可选优化 #

如果后续参数增多，可将参数封装为独立的查询类，统一指定绑定来源：

// 定义查询参数类
public class AttendeeQueryParameter
{
    public TicketingModes EventType { get; set; }
    public int? ShowId { get; set; }
}

// 接口写法简化
[HttpGet]
public DataActionResponse<IList<AttendeeDetailModel>> GetAll([FromQuery] AttendeeQueryParameter parameter)
{
    return null;
}

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