Spring Boot部署服务器404页面Thymeleaf变量为空问题咨询

1. 生产环境错误属性暴露限制 #

Spring Boot为避免敏感信息泄露，默认在生产环境下会限制错误页面模型中暴露的属性：

• server.error.include-message：生产环境默认值为never，本地开发环境（dev）默认是always，如果你的模板使用了${message}这类变量，生产环境就会为空。
• server.error.include-stacktrace：生产环境默认never，dev环境always，若模板用到${trace}也会出现空值。
• 类似的还有server.error.include-exception、server.error.include-binding-errors等属性，生产环境默认都不会暴露。

解决方式：在生产环境配置文件（如application-prod.properties）中按需开启需要的属性，示例：

server.error.include-message=always
server.error.include-stacktrace=on_param # 按需选择always/on_param/never
server.error.include-exception=true

2. Thymeleaf缓存导致模板未生效 #

生产环境下spring.thymeleaf.cache默认开启（值为true），如果错误模板是后期修改的，打包时可能未更新缓存，或者部署后缓存未失效，导致变量渲染逻辑没有正常执行。

解决方式：部署前确认打包包含最新模板文件，排查阶段可临时关闭缓存（不建议长期在生产环境使用）：

spring.thymeleaf.cache=false

3. 打包或资源加载路径异常 #

如果是打包成JAR/WAR包部署，可能存在模板文件未被正确打包到指定路径的情况。比如/resources/templates/error/下的HTML文件是否存在于最终包内。

解决方式：检查打包后的文件结构，确认JAR包的BOOT-INF/classes/templates/error/目录，或WAR包的WEB-INF/classes/templates/error/目录下存在对应的错误模板。同时检查Maven/Gradle配置，确保资源文件未被排除在打包范围外。

4. 外部容器的错误处理配置干扰 #

如果部署到外部容器（如Tomcat）而非Spring Boot内嵌容器，外部容器的错误页面配置可能覆盖Spring Boot的默认机制，导致模型数据无法传递到Thymeleaf模板。

解决方式：检查外部容器的错误页面配置，比如Tomcat的web.xml中是否存在自定义错误页面配置，这类配置会绕过Spring Boot的BasicErrorController，导致变量为空。移除容器级别的错误页面配置，交由Spring Boot处理错误即可。

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