Java Web应用可通过Tomcat日志解析、Spring拦截器或OpenAPI元数据统计API版本调用量，结合路径标准化与监控告警实现版本健康度评估。
在Java Web应用中，Apache（通常指Apache HttpClient或Apache Tomcat）本身不直接提供API版本使用率监控功能，但可以通过请求路径（如 /api/v1/users、/api/v2/users）的访问日志或拦截机制，统计各版本API的调用量，从而评估迭代效果和下线优先级。
利用Tomcat访问日志提取版本路径调用频次
Tomcat默认记录完整请求路径（如 GET /api/v1/orders?id=123 HTTP/1.1），可通过正则解析日志文件，按版本路径聚合计数：
- 配置
conf/server.xml中的AccessLogValve，确保pattern包含%r（请求行），例如：
pattern="%h %l %u %t "%r" %s %b %D" - 编写脚本（如Python或Shell）定期解析日志，提取
GET /api/v[0-9]+/.*或POST /api/v[0-9]+/.*路径，按版本分组统计次数 - 将结果写入时序数据库（如InfluxDB）或导出为CSV，供BI工具分析趋势
通过Spring MVC拦截器动态统计版本调用
若项目基于Spring Boot，可在Controller层前统一拦截请求路径，识别并记录版本信息：
- 定义
HandlerInterceptor，在preHandle中解析request.getRequestURI()，用正则匹配/api/v(\d+)/ - 使用
ConcurrentHashMap<String, AtomicLong>或 Micrometer 的Counter按版本维度累加（如api.version.calls{version="v1"}） - 配合Prometheus暴露指标，或定时落库到MySQL/Redis，支持实时看板展示
结合OpenAPI规范实现自动化版本路由标记
若API已使用Swagger/OpenAPI描述，可借助 springdoc-openapi 提取路径与版本元数据，辅助监控逻辑：
立即学习“Java免费学习笔记（深入）”；
- 在启动时扫描所有
@Operation或@Api注解，提取tags或description中隐含的版本标识 - 将路径与版本映射关系注册到内存缓存，拦截器比对时更精准（避免误判如
/v1/test非API路径） - 生成版本健康度报告：调用量下降超30%且持续7天的v1接口，建议标记为“待弃用”
不复杂但容易忽略的是路径标准化——确保前端调用、网关路由、后端接收的路径格式一致（如是否带前缀 /api、大小写、尾部斜杠），否则统计会失真。建议在API网关（如Spring Cloud Gateway）层统一做路径归一化后再透传。
