.NET Core 5.0 控制器同一路由兼容GET和POST请求的参数绑定问题

问题根因 #

这个现象本质是ASP.NET Core开启[ApiController]后，框架默认的参数绑定规则导致的：

• 不带任何绑定源标记的参数，框架会根据请求方法自动选择默认绑定来源：GET请求默认从URL查询字符串（Query）读取参数值，POST/PUT等请求默认从请求体（Body）读取参数值。
• 你测试用的POST请求发送的是application/x-www-form-urlencoded格式的表单数据，框架默认不会将这类格式的Body数据按表单解析，因此拿不到accountID参数，最终返回null。
• 你之前的代码存在路由配置冗余的问题：[HttpGet("GetAccount")]、[HttpPost("GetAccount")]里已经指定了相对路由模板，同时又在Action上加了[Route("api/accounts/GetAccount")]，会导致框架生成两层可匹配的路由，和你预期的/api/accounts/GetAccount路径不完全一致，甚至触发路由匹配冲突。直接把完整路由模板写在HTTP方法特性里，去掉单独的[Route]标记，就能准确匹配目标路径。

可直接落地的实现方式 #

方案1：统一手动读取参数来源（兼容性最强，完全适配现有测试代码） #

不需要修改前端的JS调用逻辑，直接调整Action代码即可，不管是GET带Query参数，还是POST带表单参数，都能正常取值：

[Produces("application/json")]
[ApiController]
public class AccountController : ControllerBase
{
    // 把完整路由模板直接写在HTTP方法特性里，去掉冗余的[Route]标记
    [HttpGet("api/accounts/GetAccount")]
    [HttpPost("api/accounts/GetAccount")]
    public string GetAccount()
    {
        // 优先读取GET请求的查询参数，没读到就读取POST请求的表单参数
        var accountID = Request.Query["accountID"].FirstOrDefault() 
                        ?? Request.Form["accountID"].FirstOrDefault();
        return "echoing accountID: " + accountID;
    }
}

方案2：显式绑定多来源参数（依赖框架自动绑定） #

如果不想手动读取Request对象，也可以拆分成两个参数分别对应不同的绑定来源，最终在方法内合并取有效值：

[Produces("application/json")]
[ApiController]
public class AccountController : ControllerBase
{
    [HttpGet("api/accounts/GetAccount")]
    [HttpPost("api/accounts/GetAccount")]
    public string GetAccount([FromQuery] string accountIDQuery, [FromForm] string accountIDForm)
    {
        // 合并两个来源的参数值，存在哪个就用哪个
        var accountID = accountIDQuery ?? accountIDForm;
        return "echoing accountID: " + accountID;
    }
}

配套Startup配置优化建议 #

你当前的ConfigureServices方法存在控制器服务重复注册的冗余：

// 重复调用三次控制器注册逻辑，无功能增益
services.AddControllers();
services.AddControllers().AddNewtonsoftJson();
services.AddControllersWithViews();

如果是纯API项目，只需要保留services.AddControllers().AddNewtonsoftJson();即可，重复注册不会带来新能力，反而会增加不必要的服务初始化开销。

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