jcabi @Loggable注解未生成日志求助：手动加日志太繁琐

我太懂手动加调试日志的痛苦了，@Loggable本来应该帮我们省不少事，没生效确实闹心。咱们一步步排查解决：

1. 先确认依赖是否完整且版本匹配 #

JCabi的@Loggable依赖两个核心包：jcabi-aspects（提供注解和切面逻辑）和aspectjweaver（负责切面织入），缺一个都不行。如果只加了前者，肯定不会生效。

Maven配置示例 #

<dependency>
  <groupId>com.jcabi</groupId>
  <artifactId>jcabi-aspects</artifactId>
  <version>0.22.6</version> <!-- 建议用最新稳定版，避免版本兼容问题 -->
</dependency>
<dependency>
  <groupId>org.aspectj</groupId>
  <artifactId>aspectjweaver</artifactId>
  <version>1.9.20.1</version> <!-- 选择和jcabi-aspects兼容的版本 -->
</dependency>

Gradle配置示例 #

implementation 'com.jcabi:jcabi-aspects:0.22.6'
implementation 'org.aspectj:aspectjweaver:1.9.20.1'

2. 确保AspectJ织入生效（最常见的坑） #

@Loggable是基于AspectJ实现的，必须让AspectJ把切面逻辑织入到你的代码中，否则注解就是个空架子。

普通Java项目（非Spring） #

启动JVM时必须添加javaagent参数，指定aspectjweaver的jar路径：

-javaagent:/你的本地路径/aspectjweaver-1.9.20.1.jar

比如IntelliJ中，在Run/Debug配置的「VM options」里添加这条参数，路径可以直接用Maven/Gradle仓库里的路径，比如~/.m2/repository/org/aspectj/aspectjweaver/1.9.20.1/aspectjweaver-1.9.20.1.jar。

Spring Boot项目 #

有两种可靠的方式：

• 方式一：启用Spring的AspectJ自动代理
  在application.properties中添加：

  spring.aop.proxy-target-class=true
  spring.aspectj.autoproxy=true
  

  同时在启动类上加上注解：

  @SpringBootApplication
  @EnableAspectJAutoProxy(proxyTargetClass = true)
  public class YourApplication {
      public static void main(String[] args) {
          SpringApplication.run(YourApplication.class, args);
      }
  }
  

• 方式二：直接添加javaagent参数（和普通项目一样），这种方式对类方法、接口方法都能生效，比Spring动态代理更稳定。

3. 检查@Loggable的使用规范 #

• 不能加在private方法上：AspectJ无法织入私有方法，注解要加在public、protected或者包访问权限的方法上。
• 确认日志级别：默认@Loggable的日志级别是INFO，如果你的日志框架（比如Logback）配置中，该类的日志级别高于INFO（比如WARN），注解生成的日志会被过滤。可以显式指定级别：

  @Loggable(Loggable.DEBUG)
  public void yourMethod(String param) {
      // 方法逻辑
  }
  

4. 排查日志框架配置 #

虽然你的手动log.info()能输出，但要确认日志配置没有过滤JCabi相关的日志。比如检查Logback的配置文件，有没有类似logger.com.jcabi=OFF的配置，如果有，改成INFO或更低级别。

5. 验证切面是否加载成功 #

启动项目时，搜索控制台日志中的LoggableAspect或jcabi关键词，如果能看到AspectJ加载该切面的日志，说明织入成功；如果没有，回到步骤2重新检查织入配置。

完整示例代码 #

import com.jcabi.aspects.Loggable;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class DemoService {
    private static final Logger log = LoggerFactory.getLogger(DemoService.class);

    @Loggable(Loggable.INFO)
    public void doSomething(String param) {
        log.info("手动添加的日志");
    }

    public static void main(String[] args) {
        DemoService service = new DemoService();
        service.doSomething("test");
    }
}

配置正确的话，控制台会输出：

[INFO] com.jcabi.aspects.aj.MethodLogger: #doSomething('test') entered
[INFO] DemoService: 手动添加的日志
[INFO] com.jcabi.aspects.aj.MethodLogger: #doSomething('test') exited, 1ms

内容的提问来源于stack exchange，提问作者santhosh kumar