Spring Boot部署非根上下文时静态资源URL匹配错误求助

核心原因1：外部Tomcat忽略server.servlet.context-path配置 #

server.servlet.context-path是Spring Boot内嵌容器的专属配置项，当你把war包部署到外部独立Tomcat时，这个配置会被Tomcat自身的上下文规则覆盖。外部Tomcat的上下文路径由以下因素决定：

• war包的文件名（比如myApp.war部署后上下文默认就是/myApp）
• Tomcatserver.xml配置文件里<Context>标签的path属性
• Tomcatconf/Catalina/localhost目录下的XML配置文件名称

解决方法：

• 由Tomcat控制上下文：把war包重命名为myApp.war，或者在server.xml中添加<Context path="/myApp" docBase="你的war包绝对路径" reloadable="true"/>
• 由Spring Boot接管上下文：不要部署war包，直接运行jar包，此时server.servlet.context-path=/myApp配置会直接生效

核心原因2：前端资源硬编码绝对路径 #

绝大多数资源加载失败的问题，根源在于前端资源的引用方式错误——比如直接写了<link href="/css/style.css">，这种写法会直接请求localhost:8080/css/style.css，不会自动带上/myApp上下文前缀。

解决方法：

• 用模板引擎的路径解析功能：
  • Thymeleaf：使用@{/css/style.css}，它会自动拼接上下文路径，最终生成/myApp/css/style.css
  • JSP：使用${pageContext.request.contextPath}/css/style.css获取上下文路径后拼接
• 纯HTML静态页面：通过JavaScript动态获取上下文路径，示例代码：

  const contextPath = window.location.pathname.split('/')[1];
  const cssUrl = `/${contextPath}/css/style.css`;
  

• 尽量避免使用以/开头的绝对路径，改用相对路径（注意页面层级，复杂页面不推荐）

其他排查点 #

• 检查静态资源配置：确保spring.web.resources.static-locations配置的是相对路径（默认classpath:/static/无需修改），Spring Boot会自动处理上下文路径映射
• 检查反向代理配置：如果用了Nginx等代理，确保代理规则没有丢失上下文路径，比如Nginx的proxy_pass要写http://localhost:8080/myApp/而非http://localhost:8080/

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