本文介绍在 spring mvc 控制器中，如何从 `httpservletrequest` 中提取原始请求路径（如 `/getuser/`），自动剥离 `@pathvariable` 动态段，避免手动硬编码或字符串解析错误。
在 Spring MVC 开发中，常需基于当前请求路径进行日志记录、权限校验、链路追踪或动态路由匹配。但直接调用 request.getRequestURI() 或 request.getServletPath() 会返回包含实际路径变量值的完整路径（例如 /getUser/tommy），而我们真正需要的是模板化路径——即控制器映射定义中的静态部分（如 /getUser/{username} 对应的 /getUser/）。
Spring MVC 本身未提供开箱即用的 API 直接返回“无变量路径”，但可通过组合 HttpServletRequest 的标准方法 + 路径变量信息，安全、可靠地还原出目标路径。
核心思路：利用 getServletPath() 与 @PathVariable 协同推导
HttpServletRequest.getServletPath() 返回的是当前请求匹配到的 Servlet 映射路径（不含上下文路径和查询参数），它已由 Spring 解析并去除了上下文前缀，是计算的基础。关键在于：路径变量值必然位于 getServletPath() 的末尾，且其位置可被精确识别。
以下是一个健壮、可复用的实现方式：
@GetMapping("/getUser/{username}")
public ResponseEntity getUser(
@PathVariable String username,
HttpServletRequest request) {
String servletPath = request.getServletPath(); // e.g. "/getUser/tommy"
// 安全截取：从末尾移除变量值及前导斜杠
int lastSlashIndex = servletPath.lastIndexOf('/');
if (lastSlashIndex > 0 && servletPath.length() > lastSlashIndex + username.length()) {
String pathWithoutVar = servletPath.substring(0, lastSlashIndex + 1); // 保留末尾 '/'
// 或使用 substring(0, lastSlashIndex) 获取不带尾部 '/' 的版本（如 "/getUser"）
System.out.println("Template path: " + pathWithoutVar); // 输出："/getUser/"
}
// ... 业务逻辑
return ResponseEntity.ok(new UserDTO());
} ✅ 优势说明： 不依赖正则或硬编码路径模板，完全基于运行时真实请求信息； 避免因多级嵌套变量（如 /api/v1/users/{id}/posts/{postId}）导致的解析歧义； lastIndexOf('/') 确保只移除最后一个路径段（即最外层 @PathVariable），符合 RESTful 设计惯例。
注意事项与最佳实践
-
仅适用于单个末尾 @PathVariable 场景：上述方法默认假设动态段位于路径最末端。若存在多个变量（如 /{year}/{month}/{day}），建议改用 HandlerMapping.BEST_MATCHING_PATTERN_ATTRIBUTE（需启用 useRegisteredSuffixPatternMatch）：
String pattern = (String) request.getAttribute(HandlerMapping.BEST_MATCHING_PATTERN_ATTRIBUTE); // pattern = "/getUser/{username}" → 可直接用于审计或路由匹配 - 空值与边界检查不可省略：username 可能为空字符串或含斜杠（虽不推荐），务必校验 lastSlashIndex 和长度，防止 StringIndexOutOfBoundsException。
- 上下文路径隔离：getServletPath() 已排除 getContextPath()，因此无需额外处理上下文（如 /myapp），结果天然可移植。
-
替代方案对比：
- ❌ request.getRequestURI() 包含完整 URI（含上下文），需额外裁剪；
- ❌ 正则替换 /{[^}]+} 易受路径中特殊字符干扰，且无法区分模板与字面量；
- ✅ getServletPath() + lastIndexOf('/') 是轻量、标准、零依赖的最优解。
综上，在绝大多数标准 REST 接口场景下，通过 request.getServletPath() 结合 @PathVariable 值进行末段截断，是最简洁、高效且符合 Servlet 规范的实现方式。它既规避了框架内部实现细节耦合，又保持了代码的可读性与可维护性。
