ASP.NET Core Web API路由配置正确性咨询及多请求方法实现疑问

当前配置的问题 #

你控制器的路由是[Route("api/[controller]/[action]")]，意味着每个方法的路由前缀是api/{控制器名}/{方法名}。你添加的Get方法路由模板是[HttpGet("{someId}/{someName}/{someDateTime}/someBool")]，这里的someBool是固定字符串而非参数占位符（没有用{}包裹），所以这个方法仅匹配包含/someBool路径段的请求（比如Swagger生成的https://localhost:7062/api/Weather/Get/65974/Jack%20Smith/1954-03-10/someBool?someBool=false）。

而Postman发送的https://localhost:7062/api/Weather/Get?someId=65974&someName=Jack Smith&someDateTime=1954-03-10&someBool=false没有/someBool这段路径，路由系统无法匹配到你的带参Get方法，因此触发了无参的Get方法。

修正方案 #

根据你的需求，分两种场景调整：

场景1：使用路由参数（参数在URL路径中） #

如果你希望参数以路径形式传递（如/api/Weather/Get/123/Jack/2024-01-01/true），修改Get方法的路由模板，把someBool也设为参数占位符：

[HttpGet("{someId}/{someName}/{someDateTime}/{someBool}")]
public IActionResult Get(int someId, string someName, DateTime someDateTime, bool someBool)
{
    return Ok($"Value passed: {someId}/{someName}");
}

此时Swagger和Postman使用路径形式传递参数，都能正确触发该方法。

场景2：使用查询参数（参数在URL的?之后） #

如果你希望用Postman那种Query参数的方式传递（更灵活，支持可选参数），不需要在[HttpGet]模板中定义参数，直接保留方法参数即可：

[HttpGet]
public IActionResult Get(int someId, string someName, DateTime someDateTime, bool someBool)
{
    return Ok($"Value passed: {someId}/{someName}");
}

此时请求URL为/api/Weather/Get?someId=65974&someName=Jack%20Smith&someDateTime=1954-03-10&someBool=false，就能正确匹配到该方法，不会触发无参Get。

多参数GET/POST的最佳实践 #

GET方法 #

• 对于必填的标识类参数（如ID），优先用路由参数（符合REST风格）；
• 对于可选的筛选、分页参数，用查询参数更灵活；
• 如果有多个不同逻辑的GET方法，通过不同的Action名称区分（比如GetById、GetByName），或者给[HttpGet]添加不同的路由后缀（如[HttpGet("by-name")]）。

POST方法 #

POST通常用于提交复杂数据，建议将参数封装为模型类，通过请求体传递：

[HttpPost]
public IActionResult Create([FromBody] WeatherRequest request)
{
    // 处理业务逻辑
    return Ok($"Received: {request.SomeId}/{request.SomeName}");
}

// 定义请求模型
public class WeatherRequest
{
    public int SomeId { get; set; }
    public string SomeName { get; set; }
    public DateTime SomeDateTime { get; set; }
    public bool SomeBool { get; set; }
}

如果有多个POST方法，同样可以通过Action名称（如Create、BatchUpdate）或路由后缀（[HttpPost("batch")]）区分。

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