ASP.NET Core 7 Web API可选查询参数wind无法捕获问题

最常见的原因是curl命令的语法错误，尤其是不同终端环境对&符号的特殊处理：

• 在Windows的CMD/PowerShell里，&是命令分隔符，直接写curl http://xxx?when=xxx&wind=xxx时，终端会把&后的wind=xxx当成新命令执行，导致第二个参数根本没传到API服务。
• 在Linux/macOS的Bash里，&会让curl进程后台运行，同样会导致第二个参数丢失。

解决办法很直接，把整个URL用双引号包裹，确保查询参数被完整传递：

curl "https://localhost:5001/sensors/your-sensor-name?when=2024-05-20&wind=15"

如果问题还存在，再排查这几个点：

• 检查curl里的参数名和Controller方法里的参数名完全一致（比如方法里是wind，别写成Wind或windSpeed），虽然ASP.NET Core默认参数名大小写不敏感，但拼写错误还是容易踩坑。
• 用浏览器或抓包工具（比如Fiddler）查看实际发送的请求URL，确认when和wind两个参数是否都在查询字符串里。如果请求里只有一个参数，那还是curl命令的问题；如果两个都有但API没捕获到，再检查参数类型是否匹配（比如wind是int类型，别传了非数字值）。
• 确认方法里的[FromQuery]特性没有写错，比如别把wind的特性误写成[FromRoute]。

附一个标准的Controller方法示例供你对比：

[ApiController]
[Route("sensors")]
public class SensorsController : ControllerBase
{
    [HttpGet("{sensorname}/zforecast")]
    public IActionResult GetZForecast(string sensorname, [FromQuery] DateTime? when, [FromQuery] int? wind)
    {
        return Ok(new { SensorName = sensorname, When = when, Wind = wind });
    }
}

内容的提问来源于stack exchange，提问作者László Frank