如何在Thymeleaf中引用Spring Web命名@RequestMapping的URL避免重复维护

核心方案：Spring MVC命名路由 + Thymeleaf MVC表达式 #

Spring MVC的@GetMapping的name属性就是对应Django路由的name参数，用来给路由指定唯一标识，结合Thymeleaf的Spring MVC表达式可直接引用这个标识生成URL，彻底摆脱硬写路径的维护痛点。

步骤1：给控制器路由命名 #

在控制器中通过name属性为路由设置全局唯一名称：

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

@Controller
public class HelloController {
    // 命名路由为"helloPage"，路径可随时修改
    @GetMapping(path = "/hello", name = "helloPage")
    public String hello() {
        return "hello"; // 返回Thymeleaf模板名
    }
}

步骤2：Thymeleaf模板中引用命名路由 #

在模板中使用#mvc表达式调用路由名称生成URL，无需硬写/hello：

<!-- 直接引用路由名称，路径变化时无需修改模板 -->
<a th:href="@{${#mvc.url('helloPage').build()}}">Hello</a>

带参数的路由场景 #

如果路由包含路径参数（如/user/{id}），同样可以通过命名路由传递参数：

控制器代码：

@GetMapping(path = "/user/{id}", name = "userDetail")
public String userDetail(@PathVariable Long id) {
    // 业务逻辑处理
    return "user-detail";
}

Thymeleaf模板代码：

<!-- 自动填充路径参数，生成正确URL -->
<a th:href="@{${#mvc.url('userDetail').arg(0, user.id).build()}}">查看用户详情</a>

备选方案：常量类统一管理路由路径 #

如果偏好直接维护路径字符串，可以创建常量类统一管理所有路由：

1. 创建路由常量类 #

public class RouteConstants {
    public static final String HELLO_PATH = "/hello";
    public static final String USER_DETAIL_PATH = "/user/{id}";
}

2. 控制器引用常量 #

@GetMapping(path = RouteConstants.HELLO_PATH, name = "helloPage")
public String hello() {
    return "hello";
}

3. Thymeleaf模板引用常量 #

<a th:href="@{${T(com.yourpackage.RouteConstants).HELLO_PATH}}">Hello</a>

注意事项 #

• Spring Boot自动配置已包含Thymeleaf的SpringMvcDialect，无需额外配置即可使用#mvc表达式。
• 路由名称必须全局唯一，避免不同控制器的路由重名导致冲突。
• 优先选择命名路由方案，它完全解耦了路径字符串与模板引用，修改路径仅需更新控制器的path属性，所有模板会自动生成新URL，彻底解决重复代码维护问题。

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