springboot2.7中，后臺接口使用@RequestParam進行傳參，但是傳入的參數(shù)內(nèi)容過大，導(dǎo)致報錯 

request header is too large

一、報錯內(nèi)容

問題原因：

請求頭超過了tomcat的限制值。post請求是沒有參數(shù)大小限制，但是服務(wù)器有自己的默認(rèn)大小

SpringBoot內(nèi)嵌的Tomcat服務(wù)器默認(rèn)限制是8KB

二、原因分析與解決方案概述

解決方案概述：

主要通過調(diào)整配置文件增大請求頭大小限制，并優(yōu)化請求頭內(nèi)容。

三、解決方法

3.1、調(diào)整應(yīng)用程序配置（主要解決方案）

根據(jù)你的 Spring Boot 版本和使用的配置文件格式（properties 或 yml），進行如下配置：

Spring Boot 2.x 配置

在 application.properties 文件中添加：

# 設(shè)置最大 HTTP 請求頭大小為 100KB (推薦初始值)
server.max-http-header-size=100KB

或者使用字節(jié)單位：

# 設(shè)置最大 HTTP 請求頭大小為 102400 字節(jié) (100KB)
server.max-http-header-size=102400

在 application.yml 文件中添加：

server:
  max-http-header-size: 100KB

或者：

server:
  max-http-header-size: 102400

Spring Boot 3.x 配置

從 Spring Boot 3.0 開始，max-http-header-size 參數(shù)已被棄用，建議使用 max-http-request-header-size：

server:
    max-http-request-header-size: 12KB

3.2、通過代碼配置（備用方案）

如果配置文件方式不生效，你可以在啟動類或配置類中通過代碼配置：

import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.boot.web.server.WebServerFactoryCustomizer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class ServerConfig {

    @Bean
    public WebServerFactoryCustomizer<TomcatServletWebServerFactory> containerCustomizer() {
        return factory -> factory.addConnectorCustomizers(connector -> {
            connector.setMaxHttpHeaderSize(102400); // 設(shè)置為100KB
        });
    }
}

3.3、直接配置 Tomcat（適用于外部 Tomcat）

如果你的 Spring Boot 應(yīng)用部署在獨立的 Tomcat 服務(wù)器上，需要修改 Tomcat 的 server.xml 文件：

<Connector 
    port="8080" 
    protocol="HTTP/1.1"
    connectionTimeout="20000"
    redirectPort="8443"
    maxHttpHeaderSize="102400" />

重啟 Tomcat 使配置生效。

四、注意事項

• 不要盲目設(shè)置過大值：設(shè)置過大的請求頭限制會增加內(nèi)存消耗，在并發(fā)請求時可能造成內(nèi)存溢出（OOM）。應(yīng)根據(jù)實際業(yè)務(wù)需求設(shè)置合理值。
• 檢查反向代理配置：如果你的應(yīng)用前面有 Nginx 或 Apache 等反向代理服務(wù)器，這些服務(wù)器也可能有類似的請求頭大小限制（例如 Nginx 的 large_client_header_buffers 指令），需要一并調(diào)整。

優(yōu)化請求頭設(shè)計：

• 避免在請求頭中存儲大量數(shù)據(jù)（如大型 Base64 編碼的圖片）。
• 考慮將大數(shù)據(jù)存儲在請求體（Body）而非請求頭中。
• 對于 GET 請求參數(shù)過長的情況，考慮改為 POST 請求，將參數(shù)放在請求體中。

五、總結(jié)

以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。 

最新評論