自托管OData/WebAPI长URL报400错误，能否配置支持长参数？

这个问题我碰到过好几次了，本质是服务器和WebAPI/OData的默认URL长度限制在搞鬼，咱们一步步来解决：

1. 先调整服务器层面的URL长度限制 #

不管是IIS还是自托管的HttpListener，默认都有URL长度上限，超过就会直接返回HTTP Error 400. The request URL is invalid：

• 如果是IIS托管：修改项目根目录的Web.config，添加/调整以下节点：

<system.web>
  <!-- maxUrlLength是URL总长度（字符数），maxQueryStringLength是查询字符串长度 -->
  <httpRuntime maxUrlLength="10999" maxQueryStringLength="2097151" />
</system.web>
<system.webServer>
  <security>
    <requestFiltering>
      <!-- 这里的单位是字节，要和上面的数值对应 -->
      <requestLimits maxUrl="10999" maxQueryString="2097151" />
    </requestFiltering>
  </security>
</system.webServer>

• 如果是自托管（比如OWIN）：在启动代码里配置HttpListener的相关限制：

using System.Net;

// 初始化HttpListener
var listener = new HttpListener();
listener.Prefixes.Add("http://localhost:8080/api/bookings/");
// 调整请求队列上限，避免因长请求阻塞
listener.RequestQueueLimit = 1000;
// 同时可以放宽ServicePointManager的连接限制
ServicePointManager.DefaultConnectionLimit = 100;

2. 配置WebAPI和OData的参数支持 #

光改服务器还不够，WebAPI和OData本身也有参数长度的限制，得同步调整：

• 在你的WebAPI配置类（比如WebApiConfig.cs）里，确保OData函数的参数没有被限制，并且路由配置正确：

public static void Register(HttpConfiguration config)
{
    // 构建OData模型，注册GetSegments函数
    ODataModelBuilder builder = new ODataConventionModelBuilder();
    builder.Namespace = "Service";
    var getSegmentsFunc = builder.Function("GetSegments")
                                 .Parameter<string>("ids") // 这里不要加长度限制
                                 .Parameter<string>("start")
                                 .Parameter<string>("end")
                                 .ReturnsCollectionFromEntitySet<Segments>("Segments");
    
    // 映射OData路由
    config.MapODataServiceRoute(
        routeName: "ODataRoute",
        routePrefix: "api/bookings",
        model: builder.GetEdmModel());
    
    // 放宽WebAPI的URI处理限制
    config.Services.Replace(typeof(IHttpControllerSelector), new DefaultHttpControllerSelector(config));
    config.Formatters.JsonFormatter.SerializerSettings.MaxDepth = 64;
}

• 另外，检查你的控制器方法GetSegments，确保ids参数没有加[MaxLength]这类限制属性。

3. 更稳妥的替代方案：改用POST传递长参数 #

如果URL长度实在太长（比如超过2000字符，部分浏览器或代理也会主动截断），推荐把长参数放到POST请求的Body里，这是更规范的做法：

• 先定义一个请求实体类：

public class SegmentRequest
{
    public string Ids { get; set; }
    public DateTime Start { get; set; }
    public DateTime End { get; set; }
}

• 修改控制器方法为POST：

public IHttpActionResult PostGetSegments([FromBody] SegmentRequest request, ODataQueryOptions<Segments> odataQueryOption)
{
    // 在这里使用request.Ids、request.Start、request.End处理业务逻辑
    // ...
}

• 请求时就用POST方式，把参数放在Body里（比如JSON格式）：

{
    "Ids": "189,196,280,301,316,329,491,511,464,528,530,527,542,372,283,259,231,56,84,98,114,135,175,154,161,85,203,206,217,284,343,344,357,419,425,112,586,432,441,448,455,462,465,358,371,385,392,399,405,413,581,526,538,531,476,490,336,508,525,499,315,260,263,281,224,238,245,246,99,57,58,77,168,180,147,126,133",
    "Start": "2018-01-20T23:00:00.000Z",
    "End": "2018-01-27T23:00:00.000Z"
}

最后要注意的点 #

• 修改完配置后一定要重启服务器，否则不会生效
• 如果用了反向代理（比如Nginx、IIS ARR），也要检查代理服务器的URL长度限制，避免被中间环节截断
• 长URL可能会带来缓存、CSRF等安全风险，POST方式相对更安全可靠

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