Spring Boot文件上传时Tomcat响应头Unicode字符报错求助

问题根源 #

Tomcat 9默认会严格校验HTTP响应头的字符，仅允许ASCII范围（0-255）内的字符，你的X-app-params响应头包含阿拉伯字符ق（属于非ASCII的Unicode字符），触发了Tomcat的安全校验规则，导致该响应头被移除并抛出IllegalArgumentException。你之前配置的URIEncoding、编码过滤器都是针对请求/响应体的编码处理，和响应头的校验规则无关，因此无法解决问题。

可行方案 #

方案1：让Tomcat放松对指定响应头的校验

如果是独立Tomcat部署：

• 打开conf/server.xml，找到对应的Connector节点，添加relaxedResponseHeaders属性，指定允许含特殊字符的响应头名称：

  <Connector port="8080" protocol="HTTP/1.1"
             connectionTimeout="20000"
             redirectPort="8443"
             relaxedResponseHeaders="X-app-params"/>
  

如果是Spring Boot内嵌Tomcat：

• 在application.properties中添加配置：

  server.tomcat.relaxed-response-headers=X-app-params
  

该配置会让Tomcat跳过对指定响应头的严格字符校验，允许非ASCII字符存在。

方案2：对响应头值进行RFC 5987标准编码

遵循HTTP规范对含非ASCII字符的响应头值编码，既符合协议要求，也不会触发Tomcat校验。示例代码如下：
Spring Boot后端处理：

import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;

// 假设响应头原始值包含ق
String rawParamValue = "包含ق的参数内容";
// 按RFC 5987规则编码
String encodedValue = "UTF-8''" + URLEncoder.encode(rawParamValue, StandardCharsets.UTF_8.name());
// 设置响应头
response.setHeader("X-app-params", encodedValue);

Angular前端解码：

import { decodeURIComponent } from '@angular/common/http';

// 从响应头获取编码后的值
const encodedHeader = response.headers.get('X-app-params');
// 解码得到原始内容
const decodedValue = decodeURIComponent(encodedHeader.split("''")[1]);

方案3：全局关闭Tomcat响应头字符校验（不推荐）

若需允许所有响应头使用非ASCII字符，可设置Tomcat系统属性：

• 独立Tomcat：在bin/catalina.sh（Linux）或bin/catalina.bat（Windows）中添加：

  # Linux
  CATALINA_OPTS="$CATALINA_OPTS -Dorg.apache.tomcat.util.http.parser.HttpParser.ALLOW_UNSAFE_HEADER_CHARS=true"
  

  rem Windows
  set CATALINA_OPTS=%CATALINA_OPTS% -Dorg.apache.tomcat.util.http.parser.HttpParser.ALLOW_UNSAFE_HEADER_CHARS=true
  

• Spring Boot内嵌Tomcat：在启动类main方法中添加：

  public static void main(String[] args) {
      System.setProperty("org.apache.tomcat.util.http.parser.HttpParser.ALLOW_UNSAFE_HEADER_CHARS", "true");
      SpringApplication.run(YourApplication.class, args);
  }
  

注意：该方案会降低安全性，不建议在生产环境使用，仅适用于测试或特殊场景。

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