-如何监听接口调用情况？🔍

在实际项目中。开发、测试和运维团队常面临以下痛点：

• 痛点一：无法实时统计每个接口的调用次数，导致流量分析困难。
• 痛点二：缺少请求参数和返回值的记录，排查问题只能靠猜测。
• 痛点三：响应耗时不可视化，性能瓶颈难还有时发现。
• 痛点四：监控方案侵入业务代码，维护成本高。

这篇文章档提供多种实现方案。帮助你尽快处理上述痛点，实现接口调用的全链路追踪。

章节阅读路线图 🗺️

1. AOP 切面方案 → 使用 Spring AOP 无侵入式监控所有接口
2. 自定义注解方案 → 选择性监控，只针对关键接口
3. HandlerInterceptor 拦截器方案 → 基于 Spring MVC 拦截器实现
4. Micrometer + Actuator 生产级方案 → 接入 Promeus + Grafana 可视化监控
5. 基于事件监听方案 → 轻量级日志埋点。无需代码改动
6. 方案对比与

AOP 切面方案 🎯

引入依赖

org.springframework.boot
spring-boot-starter-aop


com.alibaba
fastjson
1.2.83

编写切面类

package com.example.aspect;import com.alibaba.fastjson.JSON;import lombok.extern.slf4j.Slf4j;import org.aspectj.lang.ProceedingJoinPoint;import org.aspectj.lang.annotation.*;其实，import org.springframework.stereotype.Component;其实，import org.springframework.web.context.request.*;import javax.servlet.http.HttpServletRequest;import java.util.Map;老实说，import java.util.concurrent.*;import java.util.concurrent.atomic.AtomicLong;/**
* 接口监控切面
* 功能：统计每个接口的调用次数、记录传入参数、返回参数、响应耗时
*/
@Slf4j
@Aspect
@Component
public class ApiMonitorAspect {
/** 调用次数统计容器：Key=类名.方法名,Value=计数器 */
private final Map callCountMap = new ConcurrentHashMap<>;/** 切点：拦截 com.example.controller 包下所有 Controller 方法 */
@Pointcut)")
public void controllerPointcut {}
/** 环绕通知：记录请求信息、计时并输出日志 */
@Around")
public Object monitorApi throws Throwable {
// 1️⃣ 获取 HttpServletRequest
ServletRequestAttributes attrs = RequestContextHolder.getRequestAttributes;HttpServletRequest request = attrs.getRequest;String requestUrl = request.getRequestURL.toString;String httpMethod = request.getMethod;String clientIp = request.getRemoteAddr;// 2️⃣ 方法标识
String className = joinPoint.getTarget.getClass.getSimpleName;String methodName = className + "." + joinPoint.getSignature.getName;// 3️⃣ 调用次数自增
long currentCount = callCountMap.computeIfAbsent).incrementAndGet;// 4️⃣ 参数序列化
String requestParams = JSON.toJSONString);怎么说呢，// 5️⃣ 开始计时
long startTime = System.currentTimeMillis;// 6️⃣ 执行目标方法
Object result = joinPoint.proceed;// 7️⃣ 耗时计算
long elapsed = System.currentTimeMillis - startTime;按理说，// 8️⃣ 返回值序列化
String responseResult = JSON.toJSONString;// 9️⃣ 日志输出
log.info("
=== 接口监控 ===
" +
"URL : {} {}
" +
"IP : {}
" +
"方法 : {}
" +
"累计调用次数 : {}
" +
"请求参数 : {}
" +
"返回结果 : {}
" +
"耗时 : {}
"。httpMethod,requestUrl,clientIp,methodName,currentCount,truncate,truncate,elapsed);return result;}
/** 简单截断过长字符串防止日志爆炸 */
private String truncate {
int limit = 500;return > limit)?str.substring + "…" : str，话说回来，}
/** 对外暴露累计调用次数 */
public long getCallCount {
AtomicLong counter = callCountMap.get;return counter == null?0L : counter.get;}
public Map getAllCallCounts {
Map snapshot = new ConcurrentHashMap<>);callCountMap.forEach -> snapshot.put));return snapshot;老实说，}
}

输出示例

2026-08-01 12:00:01 INFO c.e.aspect.ApiMonitorAspect -
=== 接口监控 ===
URL : GET http://localhost:8080/api/user/list
IP : 192.168.1.10
方法 : UserController.listUsers
累计调用次数 : 42
请求参数 :
返回结果 : {"code":0。"data":,"msg":"成功"}
耗时 : 45
...

自定义注解方案 🏷️

定义注解 @Monitored

package com.example.annotation;import java.lang.annotation.*;@Target
@Retention
public @interface Monitored {
/** 接口描述，可选 */
String value default "";}

基于注解的切面实现

package com.example.aspect;import com.alibaba.fastjson.JSON;import com.example.annotation.Monitored;按理说，import lombok.extern.slf4j.Slf4j;import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.*;import org.springframework.stereotype.Component;其实，import java.util.Map;import java.util.concurrent.*;@Slf4j
@Aspect
@Component
public class MonitoredApiAspect {
private final Map callCountMap = new ConcurrentHashMap<>;@Pointcut")
public void monitoredPointcut {}
@Around && @annotation")
public Object monitorAnnotated throws Throwable {
String description = monitored.value;String methodName = pjp.getTarget.getClass.getSimpleName + "." + pjp.getSignature.getName;long count = callCountMap.computeIfAbsent).incrementAndGet;String params = JSON.toJSONString);不过，long start = System.currentTimeMillis;Object result = pjp.proceed;其实，long elapsed = System.currentTimeMillis - start;log.info(" {} | 方法:{} | 累计:{} | 参数:{} | 耗时:{}ms | 返回:{}",description.isEmpty?methodName:description,methodName。count,truncate,elapsed,truncate));return result;}
private String truncate{int l=400;return s，=null && s.length>l?s.substring+"…":s，}
}

使用方式示例

@RestController
@RequestMapping
public class UserController {
@Monitored
@PostMapping
public Result login{
return Result.success;}
// 未标记，不会被监控
@GetMapping
public Result list{
return Result.success);}
}

HandlerInterceptor 拦截器方案 🚦

实现拦截器 ApiMonitorInterceptor

package com.example.interceptor;import com.alibaba.fastjson.JSON;import lombok.extern.slf4j.Slf4j;import org.springframework.stereotype.Component;import org.springframework.web.servlet.*;import javax.servlet.http.*;说起来，import java.util.Map;import java.util.concurrent.*;怎么说呢，@Slf4j
@Component
public class ApiMonitorInterceptor implements HandlerInterceptor {
private final Map urlCountMap = new ConcurrentHashMap<>;private final ThreadLocal startTimeHolder = new ThreadLocal<>;private final ThreadLocal urlHolder = new ThreadLocal<>;@Override
public boolean preHandle {
String uri = request.getRequestURI;urlHolder.set;urlCountMap.computeIfAbsent).incrementAndGet;startTimeHolder.set);log.info(" {} {} | 参数:{}"。request.getMethod,uri,JSON.toJSONString));return true，}
@Override
public void afterCompletion(HttpServletRequest request,HttpServletResponse response。Object handler,Exception ex) {
try{
Long start = startTimeHolder.get;ifreturn，long elapsed= System.currentTimeMillis-start;int status = response.getStatus;String uri = urlHolder.get;if{
log.info;}else{
log.error);}
}finally{
startTimeHolder.remove;urlHolder.remove;}
}
}

注册拦截器 WebConfig

package com.example.config;import com.example.interceptor.ApiMonitorInterceptor;import org.springframework.beans.factory.annotation.Autowired;怎么说呢，import org.springframework.context.annotation.Configuration;import org.springframework.web.servlet.config.annotation.*;@Configuration
public class WebConfig implements WebMvcConfigurer {
@Autowired private ApiMonitorInterceptor apiMonitorInterceptor;@Override
public void addInterceptors{
registry.addInterceptor.addPathPatterns;}
}

Micrometer + Actuator 生产级方案 📊

依赖声明

org.springframework.boot
spring-boot-starter-actuator

i o.micrometer;怎么说呢，...

Revised Title

How to Track Interface Call Dynamics?

Overview

In modern software development and monitoring systems

...