Apache POI 5.2.2调用log4j的atDebug()方法报NoSuchMethodError

错误原因 #

出现java.lang.NoSuchMethodError: org.apache.logging.log4j.Logger.atDebug()的核心原因是项目中引入的log4j-api版本过低。atDebug()方法是Log4j 2.14.0及以上版本才新增的API，而Apache POI 5.2.2依赖的是Log4j 2.17.1版本的API，若项目中存在其他依赖引入了更低版本的log4j-api，就会出现这个方法找不到的错误。

你之前排除log4j-core的操作无法解决问题，因为错误出在log4j-api（日志API定义）而非log4j-core（日志实现）。

解决方案 #

方案1：直接引入匹配版本的Log4j依赖 #

如果你的项目本身使用Log4j2作为日志框架，直接引入与POI 5.2.2匹配的Log4j版本即可，无需排除POI中的Log4j依赖：

<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-api</artifactId>
    <version>2.17.1</version>
</dependency>
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>2.17.1</version>
</dependency>

方案2：用桥接器适配其他日志框架（如SLF4J） #

如果项目使用SLF4J+Logback等其他日志框架，可以通过log4j-to-slf4j桥接器将POI的Log4j日志转接到SLF4J，同时保留你之前对log4j-core的排除：

<!-- POI依赖（保留log4j-core排除） -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi</artifactId>
    <version>5.2.2</version>
    <exclusions>
        <exclusion>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j-core</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.2</version>
    <exclusions>
        <exclusion>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j-core</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<!-- Log4j转SLF4J桥接器 -->
<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-to-slf4j</artifactId>
    <version>2.17.1</version>
</dependency>

注意：需要确保项目中已经引入了SLF4J的具体实现（如logback-classic）。

额外检查：排查依赖冲突 #

执行Maven命令查看项目依赖树，确认是否有其他依赖引入了低版本的log4j-api：

mvn dependency:tree

如果发现有其他依赖引入了低版本的log4j-api，可通过排除该依赖中的log4j-api来解决冲突，例如：

<dependency>
    <groupId>xxx</groupId>
    <artifactId>xxx</artifactId>
    <version>xxx</version>
    <exclusions>
        <exclusion>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

内容的提问来源于stack exchange，提问作者azer-p