解决Nginx GET请求参数过大报错：从修改配置到POST跳转的完整方案

场景与问题背景

场景

近期工作中遇到一个具体需求：在页面 a.vm 中，需要对 Ajax 请求的返回结果进行判断，并将结果中的数据传递给目标 URL（b.htm），进而实现跳转到新页面 b.htm 的操作。

遇到的问题

Nginx GET请求参数过大报错分析

由于初始方案采用 GET 请求，当需要传递的数据量较大时，系统会报错 nginx 414 request-uri too long。

该错误涉及客户端请求头缓冲区大小。如果请求头的总长度小于 128k，则使用此配置的缓冲区；若超过此限制，则需参考后续说明。

client_header_buffer_size 128k;

当请求头总长度大于 128k 时，系统将使用 large_client_header_buffers 指令所设置的缓存区进行处理。

large_client_header_buffers 指令的参数中，第一个数字 4 代表缓冲区个数，第二个参数 128k 代表每个缓冲区的大小，默认值通常为 8k。此处配置为申请 4 个大小为 128k 的缓冲区。

large_client_header_buffers 4 128k;

当 HTTP 的 URI 过长，或者 request header 过大时，服务器可能会返回 414 Request URI too large 或 400 bad request 错误。

造成此类问题的原因分析

主要原因之一是 Cookie 中写入的值过大。由于 Header 中的其他参数大小通常相对固定，只有 Cookie 可能被写入较大的数据，从而导致请求头体积膨胀。

另一个常见原因是请求参数本身过长。例如，在发布文章正文时，若使用 urlencode 编码后通过 GET 方式传输到后台，极易触发长度限制。

本次故障的具体原因由上述问题 2 引起。即当请求头过大，超过 large_client_header_buffer 的限制时，Nginx 可能返回 Request URI too large (414) 或者 Bad-request(400) 错误。

具体而言，当 Request line 的长度大于 large_client_header_buffer 中设定的一个 buffer(128k)（即 buffer 128k）时，Nginx 会返回 "Request URI too large" (414) 错误，这对应于上述场景 2 的情况。

此外，请求头中最长的一行也必须小于 large_client_header_buffer。当非 Request line 的最长行大于一个 buffer（128k）时，会返回 "Bad-request"(400) 错误，这对应于上述场景 1 的情况。

临时解决方案与最终建议

临时解决办法

修改 Nginx 参数

主要需要调大以下参数的值：

client_header_buffer_size 512k;
large_client_header_buffers 4 512k;

然而，单纯调大这些值存在隐患：当服务器需要处理的数据量较大时，可能仍需再次修改配置，这并非长久之计。因此，最终的解决办法是将 GET 请求方式修改为 POST 请求方式。

使用POST跳转的完整实现

最终解决办法

使用 jquery.redirect.js 框架来处理此类情况，主要利用到的函数是 $.redirect。

代码如下：

 $http({
    method: "POST",
    dataType: "json",
    contentType: 'application/json',
    url: url,
    data: data,
   }).success(function (data) {
    if (data.success) {
     crId = data.data;
     $scope.errMsg = "";
     var url = "/xx.htm?id=" + id;
     window.location.href = url
    } else {
     $scope.errMsg = data.message;
     $scope.isDisabled = false;
     $scope.errorCode = data.code;
     $scope.trv.physics = data.data;
     if(data.statusCode === -224){
      var vms = data.data;
      console.log("vms: " + vms);

      $.redirect('/b.htm', {'vms': vms.toString(), 'resource': trv.resource, 'errMsg': $scope.errMsg});
     }

    }
   }).error(function (data) {
    alert(data);
    $scope.isDisabled = false;
   });

总结

以上就是本文的全部内容，希望本文的内容对大家的学习或者工作能带来一定的帮助。如果有疑问大家可以留言交流，谢谢大家对本站的支持。