AEM中特定Java类日志配置及依赖问题解决指引

一、解决Logger依赖问题 #

AEM默认采用SLF4J适配Logback/Log4j2的日志体系，按以下步骤处理依赖：

1. 引入正确的Maven依赖 #

在项目pom.xml中添加SLF4J API依赖，注意匹配AEM内置版本避免冲突，且设置为provided（AEM容器已自带，无需打包进bundle）：

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>1.7.36</version> <!-- 版本需与AEM内置SLF4J一致，可通过AEM依赖清单查询 -->
    <scope>provided</scope>
</dependency>

若项目已依赖AEM SDK API，可直接复用该依赖（已包含SLF4J）：

<dependency>
    <groupId>com.adobe.aem</groupId>
    <artifactId>aem-sdk-api</artifactId>
    <version>你的AEM版本号</version>
    <scope>provided</scope>
</dependency>

2. Java类中正确声明Logger #

使用SLF4J标准API声明，不要直接引用具体日志实现类：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

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

    public void businessMethod() {
        log.info("业务逻辑执行开始");
        log.debug("调试参数：{}", "test-value");
        log.error("业务执行失败", new RuntimeException("模拟异常"));
    }
}

二、配置AEM日志输出规则 #

1. 通过AEM控制台配置 #

• 登录AEM OSGi控制台（/system/console/configMgr）
• 找到Apache Sling Logging Logger Configuration，点击「新建」
• 填写核心配置项：
  • Logger Name：填入目标Java类全路径（如com.yourcompany.aem.core.YourCustomClass）或包路径（如com.yourcompany.aem.core）
  • Log Level：选择对应级别（DEBUG/INFO/WARN/ERROR）
  • Log File：指定日志文件路径（如logs/custom-business.log，AEM会自动在crx-quickstart/logs目录下生成）
• 保存配置后，日志规则立即生效（无需重启bundle）

2. 通过代码配置文件批量部署 #

在bundle的src/main/resources/config目录下创建配置文件org.apache.sling.commons.log.LogManager.factory.config-customlogger.cfg：

logger.name=com.yourcompany.aem.core.YourCustomClass
logger.level=DEBUG
logger.file=logs/custom-business.log
logger.pattern=%d{ISO8601} [%t] %-5p %c - %m%n

打包部署后，AEM会自动加载该配置。

三、常见问题排查 #

• 找不到Logger类：检查pom.xml中依赖的scope是否为provided，避免打包冲突；确认依赖版本与AEM内置版本匹配。
• 日志无输出：检查日志级别配置是否与代码中调用的级别匹配（如代码用log.debug()但控制台配置为INFO，则无法输出调试日志）；确认日志文件路径所在目录有写入权限。

内容的提问来源于stack exchange，提问作者Ishappa N