Thymeleaf th:href异常：链接未生成且无法点击的问题求助

核心问题分析 #

页面仅显示文本无法点击，本质是Thymeleaf的th:href属性未被解析，导致<a>标签没有生成有效的href属性，浏览器无法识别为可点击链接。

排查步骤与解决方案 #

1. 检查页面存放路径是否符合Thymeleaf规范 #

Spring Boot中Thymeleaf模板默认存放路径是src/main/resources/templates/，如果你的index.html放在src/main/resources/static/或其他非模板目录下：

• Spring Boot会将其当作静态资源直接返回，不会经过Thymeleaf引擎解析，th:*属性会被浏览器忽略。
• 解决：将index.html移到src/main/resources/templates/目录下。

2. 确保通过控制器映射访问页面 #

直接访问静态目录下的页面不会触发Thymeleaf解析，需要通过Controller跳转：

• 创建控制器类：

@Controller
public class IndexController {
    @GetMapping("/")
    public String showIndex() {
        return "index"; // 对应templates下的index.html
    }
}

• 启动应用后，访问http://localhost:8080/test/（对应你的context-path），此时页面会被Thymeleaf引擎处理。

3. 修正th:href的语法规范 #

你的代码中th:href=@{/index.html}未添加双引号，虽然部分场景下可解析，但不符合标准语法，可能导致解析失败：

• 修正为：

<a th:href="@{/index.html}">Reload page</a>

Thymeleaf解析后会自动拼接context-path，最终生成的HTML是<a href="/test/index.html">Reload page</a>，点击即可跳转。

4. 验证Thymeleaf配置是否正常 #

检查application.properties或application.yml中是否有禁用Thymeleaf的配置：

• 确保没有spring.thymeleaf.enabled=false这类配置。
• 你提供的依赖是正确的，无需修改。

验证方法 #

启动应用后，右键页面查看源代码：

• 如果看到<a href="/test/index.html">Reload page</a>，说明Thymeleaf解析成功；
• 如果还是<a th:href="@{/index.html}">Reload page</a>，说明页面未经过Thymeleaf处理，回到前面的步骤排查路径和控制器配置。

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