Java中AOP操作审计通过自定义注解声明需审计方法，环绕通知捕获上下文、参数、结果并异步落库，结合切点精准匹配与敏感数据脱敏，实现零侵入、合规可追溯的日志记录。
Java 中结合 AOP 实现操作审计，核心是把“谁在什么时间、什么地点、做了什么操作、结果如何”这些审计要素，从业务代码里剥离出来，统一由切面自动捕获和记录。不改一行 Service 或 Controller 逻辑，就能让关键操作自动留痕，满足合规与追溯需求。
定义带语义的自定义注解
用注解声明哪些方法需要审计，比硬编码包路径更精准、更易维护：
- 注解字段应覆盖审计刚需：如 module（模块名）、operationType（增/删/改/查）、description（支持 SpEL 动态描述，例如 "{#user.username} 删除了 ID 为 {#id} 的用户"）
- 增加安全控制开关：如 recordParams 和 recordResult 默认 false，避免密码、身份证等敏感数据被意外落库
- 标注在方法上（
@Target(ElementType.METHOD)），运行时保留（@Retention(RetentionPolicy.RUNTIME)），方便 AOP 反射读取
编写环绕通知切面类
使用 @Around 是最常用也最灵活的方式，能同时拿到入参、出参、异常和执行耗时：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 在
proceed()前获取请求上下文：通过RequestContextHolder拿到HttpServletRequest，提取 URI、Method、IP；通过SecurityContext获取当前登录用户 ID 与姓名 - 在
proceed()后组装日志实体：填充操作时间、模块、类型、描述（已解析 SpEL）、参数（按需 JSON 序列化）、返回值（若开启）、执行状态（成功/失败）、异常摘要（非完整堆栈，防日志膨胀） - 异步保存：调用
@Async方法或发消息到 MQ，避免日志写入阻塞主业务链路
精准匹配切点，避免误拦
切点表达式决定审计范围，太宽会打日志洪流，太窄则漏关键操作：
立即学习“Java免费学习笔记（深入）”；
- 推荐以注解为锚点：
@Pointcut("@annotation(com.example.LogOperation)")，只拦截明确标记的方法，零侵入且意图清晰 - 慎用包路径通配：
execution(* com.example.service..*.*(..))容易误拦工具类、内部方法，后期难收敛 - 可叠加条件：如
@annotation(logOp) && execution(public * *(..))，排除 private 方法，提升审计可信度
审计数据落地与脱敏
日志不是记完就完，存储方式和内容安全直接影响可用性与合规性：
- 结构化入库优于纯文件：建专用操作日志表，字段对齐审计要素（operator_id、module、op_type、ip、uri、cost_time_ms、status、create_time 等），便于 SQL 查询与 BI 分析
- 敏感字段必须脱敏：手机号中间四位替换成 *，身份证只留前6后4，密码字段直接跳过记录（靠
recordParams = false控制） - 设置合理保留策略：如 MySQL 表按月分区，冷数据自动归档至对象存储，防止日志库无限膨胀
