Spring Boot+Thymeleaf：static目录下index.html无法插入片段？

这个问题的核心原因很明确：Spring Boot中static目录下的文件属于静态资源，不会被Thymeleaf模板引擎解析处理。你在index.html里写的th:insert这类Thymeleaf专属指令，对于静态文件来说只是普通的HTML属性，浏览器不会识别执行，所以片段自然不会显示。而templates目录下的文件是Thymeleaf的模板文件，Spring Boot会自动用Thymeleaf引擎处理它们，所以th:insert能正常工作。

下面是两种解决思路：

方案1：将index.html移到templates目录（推荐） #

这是最符合Thymeleaf使用规范的做法，步骤如下：

1. 把static目录下的index.html移动到templates目录下。
2. 添加一个控制器映射，让根路径/指向这个模板：

@Controller
public class HomeController {
    @GetMapping("/")
    public String homePage() {
        return "index"; // Thymeleaf会自动查找templates/index.html
    }
}

这样访问/时，Thymeleaf会解析index.html里的所有指令，包括th:insert，头部片段就能正常显示了。

另外注意一下，你的HTML命名空间写的是xmlns:th="http://thymeleaf.org"，正确的应该是xmlns:th="http://www.thymeleaf.org"（多了www），虽然Thymeleaf可能兼容这个错误写法，但建议修正，避免潜在问题。

方案2：保留index.html在static目录（不推荐） #

如果因为某些原因必须把index.html留在static目录，那你没法用Thymeleaf的片段功能，只能用纯HTML的方式引入头部，比如：

<!-- 用iframe引入，体验较差 -->
<iframe src="/navbar.html" frameborder="0"></iframe>

或者用服务器端包含（比如Apache的SSI），但这种方式失去了Thymeleaf的动态能力，维护起来也麻烦，所以非常不推荐。

总结一下，把index.html移到templates目录是最优解，既符合Spring Boot+Thymeleaf的设计逻辑，又能正常使用所有模板功能。

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