震驚！SpringBoot 接口耗時監控還能這么玩，簡單到離譜！
在生產級應用中，接口的響應速度往往直接決定了用戶體驗。無論是電商網站、企業管理系統還是在線服務平臺，如果訪問時頁面遲遲無法加載，用戶的第一反應往往是“系統卡了”。但從運維和開發的角度看，這種“卡頓”背后可能是某些接口響應過慢所導致的。
那么，如何在復雜的業務環境中快速定位慢接口？如何在不影響現有業務邏輯的情況下，做到低成本、高效率地對接口耗時進行監控？本文將結合 Spring Boot 項目實踐，詳細講解如何在 零代碼入侵 的前提下，構建一套可擴展的接口耗時監控機制。
方案優勢
在設計接口耗時監控機制時，我們的目標是既要滿足生產環境的需求，又要避免對現有業務產生干擾。該方案的核心優勢包括：
零代碼入侵：不需要修改業務代碼，通過統一攔截器實現耗時采集。
統一監控策略：所有接口均能自動納入監控范圍，避免遺漏。
靈活擴展指標：除了耗時外，可擴展采集請求頭、用戶信息等更多維度。
生產環境無損接入：攔截器輕量，不會對接口性能產生明顯影響。
技術實現原理
接口耗時監控的核心思想很簡單：
- 在請求進入時記錄一個開始時間戳；
- 在請求完成時計算時間差；
- 根據耗時大小進行日志打印或告警。
在 Spring Boot 的 Web 模塊中，我們可以通過 攔截器（Interceptor） 來優雅地實現這一過程。技術架構如下圖所示：
請求 -> DispatcherServlet -> 自定義攔截器(preHandle) -> Controller -> 業務處理
-> DispatcherServlet -> 自定義攔截器(afterCompletion) -> 響應返回實現步驟
自定義攔截器
在 src/main/java/com/icoderoad/config/interceptor/RequestHeaderHandlerInterceptor.java 中定義攔截器類：
package com.icoderoad.config.interceptor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.lang.Nullable;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.HashMap;
import java.util.Map;
@Slf4j
@Component
public class RequestHeaderHandlerInterceptor implements HandlerInterceptor {
// 使用 ThreadLocal 存儲請求上下文，確保線程安全
private final ThreadLocal<Map<String, Object>> contexts = ThreadLocal.withInitial(HashMap::new);
private void set(String key, Object value) {
contexts.get().put(key, value);
}
private Object get(String key) {
return contexts.get().get(key);
}
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
long start = System.currentTimeMillis();
set("START_TIME", start);
return true;
}
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler,
@Nullable Exception ex) {
Long start = (Long) get("START_TIME");
if (start != null) {
long cost = System.currentTimeMillis() - start;
StringBuilder sb = new StringBuilder();
sb.append("接口：").append(request.getRequestURI())
.append(" 耗時：").append(cost).append("ms");
if (cost > 1000) {
log.warn(sb.toString()); // 超過1秒告警
} else {
log.info(sb.toString());
}
}
contexts.remove();
}
}這里通過 ThreadLocal 存儲每個請求的開始時間，避免多線程并發干擾。
preHandle：在請求進入時執行，記錄開始時間。afterCompletion：請求完成后執行，計算耗時并打印日志。
注冊攔截器
在 src/main/java/com/icoderoad/config/AutoWebMvcConfigurer.java 中完成攔截器注冊：
package com.icoderoad.config;
import com.icoderoad.config.interceptor.RequestHeaderHandlerInterceptor;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.annotation.Order;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
@Configuration
@Order(value = -1)
public class AutoWebMvcConfigurer implements WebMvcConfigurer {
@Autowired
private RequestHeaderHandlerInterceptor requestHeaderHandlerInterceptor;
@Override
public void addInterceptors(InterceptorRegistry registry) {
// 將自定義攔截器應用到所有接口
registry.addInterceptor(requestHeaderHandlerInterceptor).addPathPatterns("/**");
}
}通過 @Order(value = -1) 指定加載優先級，保證在 Spring MVC 執行鏈中較早生效。
日志效果
當系統接口被訪問時，你會在日志中看到類似輸出：
INFO 接口：/api/user/list 耗時：125ms
WARN 接口：/api/order/submit 耗時：1580ms這樣一來，慢接口一目了然。運維團隊可以基于日志進一步對接 監控平臺（如 ELK、Prometheus + Grafana），實現自動化告警與可視化展示。
總結
接口耗時監控是生產系統中不可或缺的一環。本文基于 Spring Boot 的攔截器機制，提供了一種 低成本、零入侵、易擴展 的實現方式。
- 對開發者而言，無需修改業務邏輯，就能快速掌握接口耗時情況；
- 對運維而言，日志輸出直觀明了，可與現有監控體系無縫對接；
- 對系統而言，監控機制輕量化，幾乎不會帶來額外性能負擔。
隨著業務規模的增長，我們還可以在此基礎上拓展更多維度，比如統計 QPS、采集請求來源、結合用戶信息等，形成完整的 接口性能監控體系。這不僅能幫助我們快速定位問題，更能為系統優化提供強有力的數據支撐。
換句話說，借助 Spring Boot 的強大擴展性，接口耗時監控完全可以做到 優雅、靈活且生產可用。
