Spring Boot如何全局设置JSPF文件编码为UTF-8？

针对你遇到的JSPF文件编码问题，核心原因是Tomcat的Jasper编译器在处理JSPF片段时，没有继承全局UTF-8编码配置——你之前尝试的方案大多针对请求响应编码，而非JSP编译阶段的编码逻辑。以下是无需逐个修改JSPF的全局解决方法：

1. 自定义Tomcat的JSP编译参数 #

Spring Boot中可以通过配置Tomcat上下文参数，强制Jasper编译器以UTF-8编码处理所有JSP/JSPF文件：

创建一个配置类：

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 TomcatJspEncodingConfig {
    @Bean
    public WebServerFactoryCustomizer<TomcatServletWebServerFactory> tomcatJspEncodingCustomizer() {
        return factory -> {
            factory.addContextCustomizers(context -> {
                // 设置JSP编译编码为UTF-8
                context.addParameter("org.apache.jasper.compiler.Encoding", "UTF-8");
                context.addParameter("pageEncoding", "UTF-8");
                // 确保Servlet规范兼容，避免编码被覆盖
                context.setServletContextAttribute("org.apache.tomcat.util.http.parser.HttpParser.STRICT_SERVLET_COMPLIANCE", true);
            });
        };
    }
}

2. 修正Eclipse中JSPF文件的默认编码关联 #

即使单个文件设为UTF-8，Eclipse可能对JSPF类型文件有全局默认编码设置：

• 打开Window -> Preferences -> General -> Content Types
• 展开Text节点，找到JSP Fragment
• 在下方Default encoding输入框填写UTF-8，点击Update保存

3. 清除Tomcat编译缓存 #

修改配置后，务必清除Tomcat的编译缓存，避免旧的编译文件干扰：

• 删除Spring Boot项目下target目录中的tomcat.*文件夹（比如target/tomcat.8080/work）
• 重启Spring Boot应用

为什么之前的方案无效？ #

• spring.http.encoding/server.servlet.encoding：仅处理HTTP请求和响应的编码，不影响JSP/JSPF的编译阶段编码
• -Dfile.encoding=UTF-8：JVM全局文件编码，但Tomcat的Jasper编译器有独立的编码配置，会覆盖该参数
• CharacterEncodingFilter：仅过滤请求响应的字符流，和JSP编译过程无关

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