本文介绍在 spring mvc 控制器中，如何从 `httpservletrequest` 中提取原始请求路径（如 `/getuser/`），剔除动态路径变量（如 `/getuser/tommy` 中的 `tommy`），适用于日志记录、权限校验或路由匹配等场景。
在 Spring MVC 中，request.getRequestURI() 返回的是完整请求路径（含路径变量），而 @RequestMapping 或 @GetMapping 注解定义的模板路径（如 /getUser/{username}）本身不直接暴露给运行时请求对象。因此，Spring 并未提供开箱即用的 API 来“反向解析”出无变量的模板路径——需结合 HttpServletRequest 的多个属性进行推导。
最可靠、轻量且与 Spring 版本解耦的方式是：利用 request.getServletPath() 获取 DispatcherServlet 映射的路径片段，并手动剥离最后一个路径段（即路径变量值）。
✅ 推荐实现方式
@GetMapping("/getUser/{username}")
public ResponseEntity getUser(
@PathVariable String username,
HttpServletRequest request) {
// 获取 Servlet 映射路径（不含 context path 和 query string）
String servletPath = request.getServletPath(); // 例如："/getUser/tommy"
// 定位最后一个 '/' 的位置，截取到该位置（保留末尾 '/'）
int lastSlashIndex = servletPath.lastIndexOf('/');
String pathWithoutVariable = lastSlashIndex > 0
? servletPath.substring(0, lastSlashIndex + 1) // 结果："/getUser/"
: servletPath;
System.out.println("Template path: " + pathWithoutVariable); // 输出：/getUser/
// 后续逻辑...
UserDTO user = userService.findByUsername(username);
return ResponseEntity.ok(user);
} ? 关键说明： request.getServletPath() 返回的是当前请求被 DispatcherServlet 处理的路径（已去除 contextPath），比 getRequestURI() 更精准； 使用 lastIndexOf('/') 而非 split("/") 可避免数组越界与空段问题，性能更优； 若需统一格式（如去掉末尾 /），可进一步调用 .replaceAll("/+$", "") 得到 /getUser。
⚠️ 注意事项与边界情况
- 多级路径变量需谨慎：若路径为 /api/v1/users/{userId}/posts/{postId}，上述方法仅移除最后一个变量（{postId}），仍保留 {userId}。此时建议结合 HandlerMapping.BEST_MATCHING_PATTERN_ATTRIBUTE（见下文进阶方案）。
- 不依赖 @PathVariable 参数名：本方案基于实际 URL 结构，与参数名（如 username）无关，避免因重命名导致逻辑失效。
- getServletPath() 的局限性：当使用 @RequestMapping 在类级别定义前缀时（如 @RequestMapping("/api")），getServletPath() 已包含该前缀，无需额外拼接。
? 进阶方案（推荐用于复杂路由）
Spring MVC 在请求处理过程中会将匹配的 AntPathMatcher 模板存入请求属性，可通过以下方式安全获取原始模式：
String pattern = (String) request.getAttribute(
HandlerMapping.BEST_MATCHING_PATTERN_ATTRIBUTE);
// 例如返回 "/getUser/{username}" —— 即真正的模板路径⚠️ 注意：该属性自 Spring 4.3+ 稳定支持，但需确保未禁用 useTrailingSlashMatch 或自定义 PathMatcher。此方式语义更准确，适合审计、监控或动态权限控制等强一致性要求场景。
✅ 总结
| 方法 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| getServletPath() + lastIndexOf('/') | 零依赖、兼容性好、性能高 | 仅适用于单路径变量末端 | 日志、简单路由识别 |
| BEST_MATCHING_PATTERN_ATTRIBUTE | 语义精确、反映真实模板 | 需 Spring ≥4.3，属内部约定属性 | 安全策略、API 网关、审计系统 |
无论选择哪种方式，请始终以 servletPath 为基准路径，避免混用 getRequestURI()（含 context path）或 getRequestURL()（含协议/域名），确保路径处理逻辑稳定、可移植。
