ASP.NET Core访问带查询参数的自定义路由返回HTTP 500错误问题

根本原因 #

报错出现在ASP.NET Core模型绑定阶段，还未进入Action逻辑：

• Action中的Dictionary<string, Microsoft.Extensions.Primitives.StringValues>属于复杂类型，默认情况下ASP.NET Core会尝试从请求Body中绑定该参数
• 你的请求是GET类型，没有请求Body，不带查询参数时模型绑定默认给该参数赋值null，能正常进入Action；带查询参数时模型绑定逻辑会尝试匹配参数与查询字符串，因为没有指定绑定源，匹配失败抛出异常，返回500。

排查验证方法 #

• 开启开发者异常页面：确认你的应用运行在开发环境，Program.cs中存在app.UseDeveloperExceptionPage();配置，再次发起带参数的请求就能看到具体的模型绑定错误详情。
• 查看控制台日志：运行应用时监听控制台输出，ASP.NET Core会打印路由匹配、模型绑定阶段的详细报错信息，可直接定位问题点。

解决方案 #

方案1（最推荐）：直接使用内置查询对象 #

移除自定义的查询字符串参数，直接用Controller基类自带的Request.Query属性获取所有查询参数，该属性本身就是IQueryCollection类型，继承自IEnumerable<KeyValuePair<string, StringValues>>，可直接当字典使用：

[Route("/arcgis/rest/services/{serviceName}/FeatureServer/{layerId}")]
public IActionResult FeatureServerLayer(string serviceName, int layerId)
{
    var queryParams = Request.Query;
    // 后续逻辑可直接读取 queryParams["f"] 等值
}

方案2：指定参数绑定源 #

如果你需要保留该方法参数，给参数添加[FromQuery]特性，明确告知模型绑定从查询字符串中读取值填充字典：

[Route("/arcgis/rest/services/{serviceName}/FeatureServer/{layerId}")]
public IActionResult FeatureServerLayer(string serviceName, int layerId, [FromQuery] Dictionary<string, Microsoft.Extensions.Primitives.StringValues>? queryString)
{
    // 原有逻辑不变
}

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