Spring MVC接口监控必备：原始路径模板获取全解析

问题场景

原始路径模板：/users/{id}
实际获取路径：/users/40000478

在监控和统计场景中，带具体参数值的路径会导致：

相同的接口被统计为多个不同的路径
难以进行有效的聚合分析
通知信息不够清晰直观

解决方案：Spring MVC路径模板获取

Spring MVC在处理请求时，会在请求属性中存储丰富的映射信息。通过以下方式可以获取原始路径模板：

import org.springframework.web.servlet.HandlerMapping;
import javax.servlet.http.HttpServletRequest;

public class MonitoringUtils {
    
    public static String getOriginalPathPattern(HttpServletRequest request) {
        // 获取最佳匹配的路径模式，如 /ad/launch/task/sendConfirmEmail/{id}
        String pattern = (String) request.getAttribute(HandlerMapping.BEST_MATCHING_PATTERN_ATTRIBUTE);
        
        // 如果获取不到路径模式，则回退到原始URI
        return pattern != null ? pattern : request.getRequestURI();
    }
}

关键请求属性详解

Spring MVC在HandlerMapping类中定义了多个有用的常量，可以从HttpServletRequest中获取：

BEST_MATCHING_PATTERN_ATTRIBUTE

用途：存储与请求最佳匹配的路径模式
场景：API监控统计的理想选择
示例值：/users/{id}

URI_TEMPLATE_VARIABLES_ATTRIBUTE

用途：存储从URL中提取的路径变量映射
场景：需要同时获取路径参数名和值时使用
示例值：{id: "40000478"}

@SuppressWarnings("unchecked")
Map<String, String> uriVariables = (Map<String, String>) request
    .getAttribute(HandlerMapping.URI_TEMPLATE_VARIABLES_ATTRIBUTE);
String id = uriVariables.get("id"); // 返回 "40000478"