Spring Boot 2.0静态资源未使用上下文路径问题排查

你遇到的核心问题是：静态HTML里的相对资源路径没有自动带上自定义配置的上下文路径，导致浏览器解析资源地址时出错。我给你整理几个实用的解决方案：

问题根源 #

当你设置server.servlet.context-path=/MyApplication后，应用的访问根路径变成了http://localhost:8080/MyApplication，但纯静态HTML里的相对路径（比如dist/main.js）是由浏览器负责解析的——它会基于当前页面URL去掉文件名后的路径来拼接，直接变成http://localhost:8080/dist/main.js，自然找不到正确的资源文件。

解决方案 #

1. 用Thymeleaf模板引擎自动适配路径（推荐） #

Spring Boot默认支持Thymeleaf，只需把index.html作为模板文件处理就能自动解决路径问题：

• 确保项目依赖中包含Thymeleaf（Spring Boot 2.0通常已默认引入）
• 在index.html的<html>标签添加Thymeleaf命名空间：

  <html xmlns:th="http://www.thymeleaf.org">
  

• 将script标签的src替换为Thymeleaf的URL语法：

  <script th:src="@{/dist/main.js}"></script>
  

Thymeleaf会自动读取你的server.servlet.context-path配置，生成带上下文的正确路径（比如/MyApplication/dist/main.js），本地运行或部署到外部Tomcat都能正常工作。

2. 给HTML添加标签统一路径基准 #

如果不想使用模板引擎，可以在index.html的<head>里动态生成<base>标签，指定所有相对路径的基准：

<head>
  <script>
    // 动态获取当前上下文路径，设置为基准路径
    const contextPath = window.location.pathname.substring(0, window.location.pathname.lastIndexOf('/'));
    document.write(`<base href="${contextPath}/">`);
  </script>
</head>

这样页面里的所有相对路径都会自动带上上下文，dist/main.js会被解析为/MyApplication/dist/main.js。

3. 硬编码上下文路径（不推荐） #

最直接但灵活性最差的方式是直接写全路径：

<script src="/MyApplication/dist/main.js"></script>

这种方式的弊端很明显——如果后续上下文路径修改，你需要手动修改所有资源引用，维护成本很高，仅适合路径永远不会变更的场景。

额外注意事项 #

如果是部署到外部Tomcat，除了application.properties里的配置，Tomcat的server.xml中<Context>标签的path属性也会影响上下文路径，建议保持两者一致，或者优先使用前两种动态路径的方式避免冲突。

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