首页 > 文章 > java教程

Java项目AOP实现操作日志记录方法

时间：2025-11-14 13:56:28 425浏览收藏

从现在开始，我们要努力学习啦！今天我给大家带来《Java项目中AOP记录用户操作日志方法》，感兴趣的朋友请继续看下去吧！下文中的内容我们主要会涉及到等等知识点，如果在阅读本文过程中有遇到不清楚的地方，欢迎留言呀！我们一起讨论，一起学习！

通过AOP与方法执行时间记录实现Java操作日志，1. 定义@LogOperation注解标记需记录的方法；2. 创建LogAspect切面类，利用@Around拦截方法执行，记录请求信息、用户、IP、URI、方法类型及执行耗时；3. 在proceed前后打点计算耗时，异常时捕获错误信息；4. 通过asyncSave异步持久化日志，避免阻塞主线程；5. 结合HttpServletRequest、SecurityContext获取上下文，增强日志可追溯性；6. 在Controller方法添加注解即可无侵入式生成带执行时间的操作日志，提升系统可观测性与审计能力。

Java项目中如何实现用户操作日志_AOP与时间记录结合应用

在Java项目中，记录用户操作日志是系统审计、问题追踪和安全监控的重要手段。通过结合AOP（面向切面编程）与方法执行时间记录，可以实现无侵入式的操作日志收集，既提升代码可维护性，又增强系统的可观测性。

1. 使用AOP捕获用户操作

AOP能够在不修改业务逻辑的前提下，拦截指定方法的调用，非常适合用于日志记录。

定义一个自定义注解，标记需要记录日志的方法：

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface LogOperation {
    String value() default ""; // 操作描述
    String type(); // 操作类型，如“查询”、“删除”
}

创建切面类，使用@Aspect和@Component注入Spring容器：

@Aspect
@Component
public class LogAspect {
<pre class="brush:java;toolbar:false;">@Autowired
private HttpServletRequest request;

@Autowired
private OperationLogService logService; // 保存日志的服务

@Around("@annotation(logOperation)")
public Object around(ProceedingJoinPoint joinPoint, LogOperation logOperation) throws Throwable {
    long startTime = System.currentTimeMillis();

    // 获取请求信息
    String ip = getRemoteIp();
    String uri = request.getRequestURI();
    String method = request.getMethod();
    String username = getCurrentUsername(); // 可从SecurityContext或Token解析

    Object result;
    try {
        result = joinPoint.proceed();
        saveLog(joinPoint, logOperation, username, ip, uri, method, startTime, "SUCCESS", null);
        return result;
    } catch (Exception e) {
        saveLog(joinPoint, logOperation, username, ip, uri, method, startTime, "FAILED", e.getMessage());
        throw e;
    }
}

private void saveLog(ProceedingJoinPoint joinPoint, LogOperation logOp, String user,
                     String ip, String uri, String method, long startTime, String status, String errorMsg) {
    long endTime = System.currentTimeMillis();
    long elapsedTime = endTime - startTime;

    OperationLog log = new OperationLog();
    log.setUsername(user);
    log.setIp(ip);
    log.setUri(uri);
    log.setHttpMethod(method);
    log.setOperationType(logOp.type());
    log.setDescription(logOp.value());
    log.setExecutionTime(elapsedTime);
    log.setStatus(status);
    log.setErrorMsg(errorMsg);

    // 可异步保存，避免影响主流程
    logService.asyncSave(log);
}

private String getRemoteIp() {
    String ip = request.getHeader("X-Real-IP");
    if (ip == null || ip.isEmpty()) {
        ip = request.getRemoteAddr();
    }
    return ip;
}

private String getCurrentUsername() {
    // 示例：从Spring Security获取
    Object principal = SecurityContextHolder.getContext().getAuthentication().getPrincipal();
    return principal instanceof UserDetails ? ((UserDetails) principal).getUsername() : "unknown";
}

}

2. 记录方法执行时间

在上述around方法中，通过System.currentTimeMillis()记录开始与结束时间，计算耗时并存入日志，便于后续分析性能瓶颈。

关键点：

在proceed前后分别打点，确保包含整个方法执行周期
即使方法抛出异常，也能记录执行时长和失败原因
将耗时写入日志字段executionTime，可用于监控慢操作

3. 日志内容优化与异步持久化

为避免阻塞主线程，日志保存建议采用异步方式：

@Service
public class OperationLogService {
<pre class="brush:java;toolbar:false;">@Async
@Transactional
public void asyncSave(OperationLog log) {
    // 插入数据库
    operationLogMapper.insert(log);
}

}

同时可在日志中加入更多上下文信息：

请求参数：joinPoint.getArgs()
目标类与方法名：joinPoint.getSignature()
用户代理（User-Agent）：request.getHeader("User-Agent")

4. 实际使用示例

在控制器方法上添加注解即可启用日志记录：

@RestController
public class UserController {
<pre class="brush:java;toolbar:false;">@LogOperation(value = "删除用户", type = "DELETE")
@DeleteMapping("/users/{id}")
public Result deleteUser(@PathVariable Long id) {
    userService.delete(id);
    return Result.success();
}

@LogOperation(value = "导出用户列表", type = "EXPORT")
@GetMapping("/users/export")
public void exportUsers(HttpServletResponse response) {
    userService.export(response);
}

}

只要方法被调用，无论成功或失败，都会生成一条带执行时间的操作日志。

基本上就这些。AOP加时间记录的方式简洁高效，适合大多数Java Web项目。关键是设计好日志模型和异步机制，保证不影响核心业务性能。

本篇关于《Java项目AOP实现操作日志记录方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！