用@around注解10分钟搭建API监控原型

原创于 2025-12-10 10:21:29 发布 · 771 阅读

CC 4.0 BY-SA版权

快速体验

打开 InsCode(快马)平台 https://www.inscode.net

输入框内输入如下内容：

快速开发一个REST API监控原型，要求：1.使用@around拦截Controller方法 2.记录接口响应时间 3.统计成功率 4.异常时发送模拟报警 5.提供简单的监控看板。使用Spring Boot+Thymeleaf实现，代码要精简但功能完整。

点击'项目生成'按钮，等待项目生成完整后预览效果

示例图片

最近在做一个后台管理系统时，突然需要给核心接口加上监控功能。领导说最好能快速看到接口健康状况，但时间又很紧。这种情况下，用Spring AOP的@Around注解快速搭建监控原型简直太合适了。下面分享我的实现思路，整个过程只用10分钟就能跑通核心功能。

为什么选择@Around注解
AOP的环绕通知可以在方法执行前后插入逻辑，特别适合这种需要统计耗时的场景。相比其他通知类型，它既能获取入参，又能拿到返回值，还能控制是否继续执行原方法。
基础环境搭建
先创建一个Spring Boot项目，引入spring-boot-starter-aop依赖。由于要展示简单看板，还需要thymeleaf模板引擎。这两个starter加进来，基础环境就准备好了。
核心监控逻辑实现
定义一个@Monitor注解作为切点标识，然后写切面类：
方法执行前记录开始时间
通过JoinPoint获取方法签名和参数
在finally块计算耗时
对异常情况单独计数并模拟发送报警（这里简单用日志代替）
统计数据存储
用ConcurrentHashMap存三组数据：
总调用次数
失败次数
最近10次耗时记录选择线程安全的容器避免并发问题
看板页面制作
用Thymeleaf写个简单页面：
顶部显示成功率百分比
表格展示接口最近耗时
用颜色区分正常/异常状态
添加刷新按钮查看最新数据
遇到的坑与解决
最初直接在切面里new了一个HashMap，压测时出现了数据错乱。后来改用ConcurrentHashMap解决。另外要注意@Around需要手动调用proceed()，忘记的话方法就不会执行了。
扩展思路
这个原型虽然简单，但很容易扩展：
添加邮件/钉钉报警
接入Prometheus做持久化
增加接口拓扑关系图
按时间维度统计趋势

整个过程最惊喜的是，用InsCode(快马)平台测试时，从编码到能看到监控页面只用了8分钟。他们的在线编辑器响应很快，还自带Spring Boot环境，不用折腾本地配置。特别是写完代码点一下部署按钮，马上就能看到运行效果，对于快速验证想法特别有帮助。

示例图片

这种轻量级监控虽然比不上专业系统，但在紧急需求或者临时验证场景下非常实用。下次需要快速原型时，我还会考虑这种AOP+内存存储的方案。

快速体验

打开 InsCode(快马)平台 https://www.inscode.net

输入框内输入如下内容：

快速开发一个REST API监控原型，要求：1.使用@around拦截Controller方法 2.记录接口响应时间 3.统计成功率 4.异常时发送模拟报警 5.提供简单的监控看板。使用Spring Boot+Thymeleaf实现，代码要精简但功能完整。

点击'项目生成'按钮，等待项目生成完整后预览效果

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考