1. 接口耗时统计的背景与价值
在分布式系统架构中,接口响应时间是衡量系统性能的核心指标之一。我们团队最近在对一个日活百万级的电商平台进行性能优化时,发现仅靠APM工具提供的全局监控数据,很难精确定位到具体接口的性能瓶颈。于是决定在Spring Boot应用层实现细粒度的接口耗时统计,这对后续的性能调优起到了关键作用。
接口耗时统计不仅仅是记录一个数字那么简单,它需要包含以下核心维度:
- 方法执行时间(从进入Controller到返回响应)
- 数据库查询耗时
- 外部服务调用耗时
- 异常情况下的耗时表现
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术方案选型与对比
2.1 常见实现方案对比
在Spring生态中,实现接口耗时统计主要有以下几种方案:
| 方案 | 实现方式 | 优点 | 缺点 |
|---|---|---|---|
| Filter | 实现javax.servlet.Filter | 实现简单,性能损耗小 | 无法获取方法级耗时 |
| Interceptor | 实现HandlerInterceptor | 可获取方法信息 | 无法统计异常耗时 |
| AOP | 使用@Around注解 | 最灵活,功能最完整 | 学习成本稍高 |
| Actuator Metrics | 内置监控端点 | 开箱即用 | 定制化能力弱 |
2.2 最终方案选择
我们选择了AOP方案,主要基于以下考虑:
- 需要统计包括异常情况在内的完整耗时
- 需要区分业务方法和外部调用
- 需要支持自定义的统计维度(如按商户、按商品类目等)
关键代码结构:
java复制@Aspect
@Component
@Slf4j
public class ApiTimeAspect {
