太全了！Spring Boot 3.4 七種方法耗時統(tǒng)計實(shí)現(xiàn)，一文搞定！
在日常開發(fā)過程中，我們經(jīng)常會遇到系統(tǒng)響應(yīng)變慢、頁面加載遲緩、接口卡頓等問題，而這些問題背后隱藏的往往是方法級性能瓶頸。隨著系統(tǒng)的不斷復(fù)雜化，代碼邏輯日益龐大，如何精準(zhǔn)定位耗時點(diǎn)，及時發(fā)現(xiàn)并優(yōu)化這些“隱形殺手”，已成為后端開發(fā)的基本功。
尤其是在 Spring Boot 3.4 日趨成熟、廣泛應(yīng)用于微服務(wù)架構(gòu)的背景下，開發(fā)者對方法執(zhí)行時間的可觀測性和性能數(shù)據(jù)的可量化性提出了更高要求。
本篇文章將以 com.icoderoad 作為標(biāo)準(zhǔn)業(yè)務(wù)包路徑，系統(tǒng)梳理 七種在Spring Boot 3.4項(xiàng)目中統(tǒng)計方法執(zhí)行耗時的主流實(shí)現(xiàn)方案，從最基礎(chǔ)的 StopWatch 手動記錄，到高級的 AOP 切面、再到生產(chǎn)級的 Micrometer + Actuator 監(jiān)控體系，全方位覆蓋應(yīng)用開發(fā)中的各類場景，助你輕松搞定耗時統(tǒng)計，提升系統(tǒng)穩(wěn)定性與可維護(hù)性！
方式一：最簡單直接 —— StopWatch手動計時
這種方式適用于臨時調(diào)試，定位具體代碼塊性能問題時很好用。
package com.icoderoad.service;
import org.springframework.stereotype.Service;
import org.springframework.util.StopWatch;
@Service
public class UserService {
public User findById(Long id) {
StopWatch watch = new StopWatch();
watch.start();
// 模擬業(yè)務(wù)操作
User user = userRepository.findById(id).orElse(null);
watch.stop();
System.out.println("findById 執(zhí)行耗時：" + watch.getTotalTimeMillis() + "ms");
return user;
}
}優(yōu)勢：無需配置、上手簡單
劣勢：代碼侵入性強(qiáng)，不適合全局使用
方式二：面向切面 —— AOP統(tǒng)一攔截統(tǒng)計
借助 Spring AOP，可以無感知地實(shí)現(xiàn)方法耗時采集。
首先，添加 AOP 依賴：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-aop</artifactId>
</dependency>切面實(shí)現(xiàn)如下：
package com.icoderoad.aspect;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.*;
import org.springframework.stereotype.Component;
import org.springframework.util.StopWatch;
@Aspect
@Component
public class PerformanceAspect {
@Pointcut("execution(* com.icoderoad.service..*(..))")
public void serviceMethods() {}
@Around("serviceMethods()")
public Object logTime(ProceedingJoinPoint joinPoint) throws Throwable {
StopWatch sw = new StopWatch();
sw.start();
Object result = joinPoint.proceed();
sw.stop();
System.out.println("方法【" + joinPoint.getSignature() + "】耗時：" + sw.getTotalTimeMillis() + "ms");
return result;
}
}優(yōu)勢：完全無侵入，集中管理
劣勢：粒度控制較弱，不適合只監(jiān)控個別方法
方式三：自定義注解 + AOP，精準(zhǔn)掌控要點(diǎn)
如果你只想統(tǒng)計某些特定方法的耗時，又不想在方法里寫邏輯，推薦這種方式。
注解定義：
package com.icoderoad.annotation;
import java.lang.annotation.*;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface TrackTime {
String description() default "";
}切面處理類：
package com.icoderoad.aspect;
import com.icoderoad.annotation.TrackTime;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.*;
import org.aspectj.lang.reflect.MethodSignature;
import org.springframework.stereotype.Component;
import org.springframework.util.StopWatch;
@Aspect
@Component
public class TrackTimeAspect {
@Around("@annotation(com.icoderoad.annotation.TrackTime)")
public Object handleTimedMethod(ProceedingJoinPoint joinPoint) throws Throwable {
MethodSignature signature = (MethodSignature) joinPoint.getSignature();
TrackTime annotation = signature.getMethod().getAnnotation(TrackTime.class);
String desc = annotation.description().isEmpty() ? signature.getMethod().getName() : annotation.description();
StopWatch sw = new StopWatch();
sw.start();
Object result = joinPoint.proceed();
sw.stop();
System.out.println("方法[" + desc + "]執(zhí)行時間：" + sw.getTotalTimeMillis() + "ms");
return result;
}
}使用方法：
package com.icoderoad.service;
import com.icoderoad.annotation.TrackTime;
import org.springframework.stereotype.Service;
@Service
public class ProductService {
@TrackTime(description = "獲取商品詳情")
public Product getProductById(Long id) {
return productRepository.findById(id).orElse(null);
}
}優(yōu)勢：可控性高、便于擴(kuò)展
劣勢：仍需手動打注解
方式四：Spring Interceptor —— 專注于Controller層
如果你只關(guān)心 Web 層接口的耗時統(tǒng)計，用攔截器最合適不過了。
攔截器類：
package com.icoderoad.interceptor;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;
import javax.servlet.http.*;
@Component
public class ApiTimerInterceptor implements HandlerInterceptor {
private final ThreadLocal<Long> startTime = new ThreadLocal<>();
@Override
public boolean preHandle(HttpServletRequest req, HttpServletResponse res, Object handler) {
startTime.set(System.currentTimeMillis());
return true;
}
@Override
public void afterCompletion(HttpServletRequest req, HttpServletResponse res, Object handler, Exception ex) {
long duration = System.currentTimeMillis() - startTime.get();
System.out.println("接口【" + req.getRequestURI() + "】耗時：" + duration + "ms");
startTime.remove();
}
}注冊攔截器：
package com.icoderoad.config;
import com.icoderoad.interceptor.ApiTimerInterceptor;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.*;
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
private final ApiTimerInterceptor interceptor;
public WebMvcConfig(ApiTimerInterceptor interceptor) {
this.interceptor = interceptor;
}
@Override
public void addInterceptors(InterceptorRegistry registry) {
registry.addInterceptor(interceptor).addPathPatterns("/api/**");
}
}優(yōu)勢：Web接口性能監(jiān)控利器
劣勢：無法統(tǒng)計 Service 等后端業(yè)務(wù)層邏輯
方式五：Actuator + Micrometer + Prometheus，專業(yè)級監(jiān)控搭檔
適合部署到生產(chǎn)環(huán)境，通過可視化儀表盤統(tǒng)一查看性能數(shù)據(jù)。
添加依賴：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
<groupId>io.micrometer</groupId>
<artifactId>micrometer-registry-prometheus</artifactId>
</dependency>服務(wù)類中記錄方法時間：
package com.icoderoad.service;
import io.micrometer.core.instrument.*;
import org.springframework.stereotype.Service;
@Service
public class OrderService {
private final MeterRegistry registry;
public OrderService(MeterRegistry registry) {
this.registry = registry;
}
public Order createOrder(OrderRequest request) {
Timer.Sample sample = Timer.start(registry);
Order order = process(request); // 假設(shè)業(yè)務(wù)邏輯處理
sample.stop(registry.timer("order.create.time"));
return order;
}
}配置 application.yml 暴露端點(diǎn)：
management:
endpoints:
web:
exposure:
include: prometheus,metrics
metrics:
export:
prometheus:
enabled: true優(yōu)勢：配合Grafana視圖完美呈現(xiàn)，適合線上
劣勢：配置偏復(fù)雜，對初學(xué)者門檻較高
方式六：Filter 過濾器方式，全鏈路請求計時
最適合做網(wǎng)關(guān)、統(tǒng)一入口類應(yīng)用的方式之一。
package com.icoderoad.filter;
import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import org.springframework.stereotype.Component;
import java.io.IOException;
@Component
public class RequestTimingFilter implements Filter {
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
long begin = System.currentTimeMillis();
chain.doFilter(request, response);
long duration = System.currentTimeMillis() - begin;
String uri = ((HttpServletRequest) request).getRequestURI();
System.out.println("請求[" + uri + "]總耗時：" + duration + "ms");
}
}優(yōu)勢：全局統(tǒng)計請求，零業(yè)務(wù)侵入
劣勢：無法細(xì)分業(yè)務(wù)邏輯耗時
方式七：事件監(jiān)聽器 —— 輕松統(tǒng)計請求執(zhí)行時間
使用 Spring 自帶的事件 ServletRequestHandledEvent，簡單高效。
package com.icoderoad.listener;
import org.springframework.context.ApplicationListener;
import org.springframework.stereotype.Component;
import org.springframework.web.context.request.ServletRequestHandledEvent;
@Component
public class HttpRequestListener implements ApplicationListener<ServletRequestHandledEvent> {
@Override
public void onApplicationEvent(ServletRequestHandledEvent event) {
System.out.println("請求【" + event.getRequestUrl() + "】處理時長：" + event.getProcessingTimeMillis() + "ms");
}
}優(yōu)勢：無侵入、自動觸發(fā)
劣勢：僅限于Controller層，無法擴(kuò)展具體邏輯耗時
最后總結(jié)：七種方案對比參考
方式 | 優(yōu)勢 | 劣勢 | 場景推薦 |
StopWatch | 快速上手 | 代碼侵入強(qiáng) | 臨時測試、調(diào)優(yōu) |
AOP | 全局統(tǒng)一、代碼無侵入 | 粒度不夠細(xì) | Service層整體監(jiān)控 |
注解 + AOP | 靈活定制、擴(kuò)展性強(qiáng) | 需手動打標(biāo)記 | 關(guān)鍵方法性能采集 |
攔截器 Interceptor | 專注接口、配置簡潔 | 僅限Controller層 | Web接口性能分析 |
Micrometer + Actuator | 專業(yè)監(jiān)控、對接Grafana | 使用門檻高 | 生產(chǎn)環(huán)境實(shí)時監(jiān)控 |
Filter | 全局請求層統(tǒng)計 | 粒度粗 | 網(wǎng)關(guān)、統(tǒng)一入口場景 |
事件監(jiān)聽器 | 系統(tǒng)自動監(jiān)聽 | 不支持業(yè)務(wù)內(nèi)部耗時 | 簡易接口請求分析 |
結(jié)語：沒有監(jiān)控的優(yōu)化都是“空談”
在性能優(yōu)化的世界里，有一句老話：“你無法優(yōu)化你不了解的東西（You can't improve what you don't measure）”。無論是對接口響應(yīng)的監(jiān)控、還是對業(yè)務(wù)邏輯執(zhí)行效率的衡量，方法耗時統(tǒng)計都是系統(tǒng)調(diào)優(yōu)的重要基石。
通過本文介紹的七種耗時統(tǒng)計手段，開發(fā)者可以：
- 快速定位耗時點(diǎn)，找出性能瓶頸；
- 精細(xì)化地監(jiān)控關(guān)鍵業(yè)務(wù)邏輯；
- 將系統(tǒng)運(yùn)行指標(biāo)納入可觀測體系，助力 DevOps；
- 在不侵入原有業(yè)務(wù)邏輯的前提下，實(shí)現(xiàn)非侵入式性能分析；
- 構(gòu)建符合生產(chǎn)要求的“性能感知型系統(tǒng)”。
每種方案都有其適用場景：手動StopWatch適合快速驗(yàn)證，AOP適合中大型系統(tǒng)的統(tǒng)一統(tǒng)計，自定義注解+AOP適合重點(diǎn)方法定點(diǎn)監(jiān)控，攔截器與Filter適合接口請求統(tǒng)計，Micrometer/Actuator則是監(jiān)控系統(tǒng)集成首選，事件監(jiān)聽提供了無需改動代碼的全局方案。
