ASP.NET可选请求体POST接口无Content-Type报415，如何兼容旧请求？

我有一个带有可选请求体（OrderRequest）的HTTP端点：

[HttpPost]
public async Task<ActionResult> Index(OrderRequest? request = null)
{
    //...
}

当发送未指定Content-Type请求头的请求时，会触发415（Unsupported Media Type）错误。为保证向后兼容性——旧版本端点无需请求体也不需要媒体类型，我需要配置该端点以支持无请求体且无媒体类型的请求。

方法1：启用空请求体绑定 #

ASP.NET Core默认会严格检查请求体格式，即使参数是可选的。可以通过以下两步配置：

1. 给参数添加[FromBody]标记：

[HttpPost]
public async Task<ActionResult> Index([FromBody] OrderRequest? request = null)
{
    //...
}

2. 在Program.cs（或Startup.cs）中配置MVC允许空输入绑定：

builder.Services.AddControllers(options =>
{
    options.AllowEmptyInputInBodyModelBinding = true;
});

配置完成后，无请求体且无Content-Type的请求会将request设为null，不会返回415错误。

方法2：调整API控制器行为 #

如果控制器标记了[ApiController]，框架会强制校验Content-Type。可以通过修改配置关闭该约束：

builder.Services.Configure<ApiBehaviorOptions>(options =>
{
    options.SuppressInferBindingSourcesForParameters = true;
});

此配置会让框架不再自动推断参数的绑定源，允许端点接受无Content-Type的空请求。

方法3：添加端点重载 #

最直接的兼容方式是添加一个无参数的POST端点重载，内部复用原有逻辑：

[HttpPost]
public async Task<ActionResult> Index()
{
    return await Index(null);
}

[HttpPost]
public async Task<ActionResult> Index(OrderRequest? request = null)
{
    //...
}

旧版请求会匹配无参数的重载，新版带请求体的请求匹配原方法，无需修改全局配置。

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