Java操作日志审计功能核心是结构化采集、安全存储与可追溯查询一体化设计，涵盖标准LogEntry实体、AOP无侵入采集、异步分表落库及基础查询导出能力，并强调上下文一致性保障可信审计。
Java操作日志审计功能的核心在于：在关键业务操作发生时，自动、准确、可追溯地记录“谁、在什么时间、对什么数据、执行了什么动作、结果如何、上下文环境怎样”。它不是简单打日志，而是结构化采集 + 安全存储 + 可查询追溯的一体化设计。
一、定义标准日志实体（LogEntry）
统一日志结构是审计可分析的前提。避免用String拼接或Map乱存，应定义不可变的POJO：
- 包含固定字段：id（UUID）、operatorId（用户ID）、operatorName（用户名）、bizType（业务类型如"USER_UPDATE"）、bizId（业务主键，如用户ID）、action（CREATE/UPDATE/DELETE）、status（SUCCESS/FAILED）、errorMsg（失败时填充）、ip（客户端IP）、userAgent（设备信息）、createTime（毫
秒时间戳）
- 支持扩展字段：用Map
extData 承载业务特有参数（如“原邮箱=xxx，新邮箱=yyy”），不破坏主结构 - 建议使用Lombok @Builder + @Value 简化构造，确保线程安全与不可变性
二、无侵入式日志采集（AOP + 注解驱动）
避免在每个service方法里手动new LogEntry，用Spring AOP切面统一拦截标记了@AuditLog的方法：
- 自定义注解@AuditLog(bizType = "ORDER_PAY", desc = "订单支付")，标注在Service方法上
- AOP切面在@AfterReturning或@AfterThrowing中提取目标方法参数、返回值、异常，并结合SecurityContext获取当前用户、RequestContextHolder获取IP
- 通过反射读取注解元数据，组装LogEntry；失败时也记录，status设为FAILED并填充异常栈摘要（勿记完整堆栈，防日志膨胀）
三、异步落库 + 分表策略保障性能与可查性
日志写入不能阻塞主业务。推荐组合方案：
- 使用Disruptor或Spring @Async将LogEntry投递至内存队列，由独立线程批量刷入数据库
- 数据库表按月分表（如audit_log_202505），配合MySQL分区或ShardingSphere管理
- 关键字段建索引：operatorId、bizType、bizId、createTime（联合索引提升按人+时间查效率）
- 敏感字段如操作前后的完整JSON快照，加密后存入TEXT字段（AES-256-GCM），密钥由KMS托管
四、提供基础查询与导出能力
审计不是只写不看。需配套轻量查询接口：
- 支持按时间范围、操作人、业务类型、状态、关键词（模糊匹配extData中的字段）组合查询
- 返回结果含高亮摘要（如“修改了手机号从138****1234 → 139****5678”），避免翻原始JSON
- 导出为Excel时，自动解密敏感字段并脱敏显示（如手机号中间四位替换为****）
- 前端可集成简易时间轴视图，直观展示某条记录的完整操作链路
不复杂但容易忽略的是上下文一致性——比如登录态丢失导致operatorId为空、异步线程中SecurityContext未传递、分布式环境下traceId未透传。这些细节决定审计是否真正可信。
