如何在WebAPI中配置maxQueryStringLength以解决超长查询字符串报错？

嘿，这个问题我之前帮不少开发者解决过！你碰到的是ASP.NET默认的查询字符串长度限制在搞鬼——默认值是2048字符，你的2154刚好超了，所以触发了The length of the query string for this request exceeds the configured maxQueryStringLength value这个错误。给你几个靠谱的解决办法：

1. 修改Web.config配置（IIS托管场景） #

这是最常见的解决方案，需要在两个节点下配置，确保覆盖不同的IIS托管模式：

针对ASP.NET运行时（经典管道模式） #

在<system.web>节点下添加或修改<httpRuntime>配置，设置更大的maxQueryStringLength值：

<system.web>
  <!-- 可以根据需求设置合适的长度，比如4096，不要设得过大避免安全风险 -->
  <httpRuntime maxQueryStringLength="4096" />
</system.web>

针对IIS请求过滤（集成管道模式） #

IIS本身会先拦截过长的请求，所以必须在<system.webServer>里配置requestFiltering：

<system.webServer>
  <security>
    <requestFiltering>
      <!-- 这里的值建议和上面的maxQueryStringLength保持一致或更大 -->
      <requestLimits maxQueryString="4096" />
    </requestFiltering>
  </security>
</system.webServer>

2. 自托管WebAPI的配置（OWIN场景） #

如果你的WebAPI是自托管（比如用OWIN搭建的），需要直接设置HttpListener的属性：

var listener = new HttpListener();
listener.Prefixes.Add("http://localhost:8080/");
// 设置你需要的最大查询字符串长度
listener.MaxQueryStringLength = 4096;

3. 更优的替代方案：改用POST请求传递参数 #

其实查询字符串本来就不适合传递大量数据，推荐你把接口改成POST请求，把原本的查询参数放到JSON请求体里。这样既规避了查询字符串的长度限制，也更符合RESTful接口的规范，数据传输也更安全。

注意事项 #

• 不要把maxQueryStringLength设得过大，避免潜在的拒绝服务攻击风险，只要满足你的业务需求即可。
• 修改配置后记得重启IIS或者你的WebAPI服务，确保配置生效。

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