Thymeleaf的th:href指令无法解析问题求助

核心问题分析 #

你遇到的情况是Thymeleaf指令未被引擎解析，本质原因是直接访问了templates目录下的静态HTML文件，而非通过Spring Controller转发请求触发Thymeleaf渲染。另外，链接路径和控制器映射不匹配也会导致后续跳转问题。

分步解决方法 #

1. 为test页面添加控制器映射

在AppsController.java中新增/test的请求映射，让Spring通过控制器转发到test模板：

package com.testapp.travelmu;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class AppsController {
    @GetMapping("/")
    public String showIndex(){
        return "index";
    }

    @GetMapping("/register")
    public String showRegister(){
        return "register";
    }

    // 新增test页面的映射
    @GetMapping("/test")
    public String showTest(){
        return "test";
    }
}

之后访问http://localhost:8080/test（而非直接访问/test.html），Thymeleaf会自动解析页面中的th:*指令。

2. 修正th:href的路径配置

控制器中注册的是/register映射，而非/register.html，需要修改test.html中的链接路径，使其匹配控制器路由：

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <a href="register.html" th:href="@{/register}">href th:href</a>
    <a th:href="@{/register}">th:href</a>
    <a href="register.html">Normal Link</a>
</body>
</html>

@{/register}会被Thymeleaf解析为指向控制器/register映射的URL，而非静态文件路径。

3. 确认Thymeleaf依赖正确引入

检查构建文件，确保已添加Spring Boot Thymeleaf starter依赖：

• Maven（pom.xml）：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

• Gradle（build.gradle）：

implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'

4. 验证Thymeleaf默认配置

Spring Boot默认已配置好Thymeleaf基础参数，若修改过application.properties或application.yml，确保以下配置正确：

# application.properties
spring.thymeleaf.enabled=true
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html

验证效果 #

重启应用后访问http://localhost:8080/test，查看页面源码：

• 带有th:href的链接会被替换为正确的控制器URL（如<a href="/register">）
• 原始的href属性会被Thymeleaf覆盖（默认优先使用th:*指令的值）

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