在AWS Lambda中使用Log4J2日志时遭遇类找不到问题

看起来你在配置Lambda的Log4J2日志时踩了常见的依赖或配置坑，我来分享几个大概率能解决问题的方向：

1. 确保引入了正确的Lambda Log4J2依赖 #

这个错误最常见的原因就是缺少aws-lambda-java-log4j2这个依赖包，Lambda运行时默认不提供这个Appender类，必须手动引入并打包到部署包中。

如果用Maven，在pom.xml里添加：

<dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-lambda-java-log4j2</artifactId>
    <version>1.5.1</version> <!-- 建议使用最新稳定版 -->
</dependency>

如果是Gradle，对应的配置：

implementation 'com.amazonaws:aws-lambda-java-log4j2:1.5.1'

⚠️ 注意：不要把这个依赖设为provided，否则打包时不会包含进去，运行时自然找不到类。

2. 检查Log4J2版本兼容性 #

aws-lambda-java-log4j2对Log4J2核心版本有要求，版本不匹配也会导致类加载失败。比如1.5.1版本的依赖对应Log4J2 2.17.x系列，你可以通过依赖树工具（Maven的mvn dependency:tree或Gradle的./gradlew dependencies）确认你的项目中Log4J2核心（log4j-core、log4j-api）的版本是否和依赖包要求的一致。

3. 验证部署包是否包含目标类 #

打包完成后，解压你的部署包（比如zip文件），检查是否存在com/amazonaws/services/lambda/runtime/log4j2/LambdaAppender.class文件。如果没有，说明依赖没被正确打包：

• 如果你用Maven Shade插件，检查配置是否排除了这个依赖；
• 如果用Gradle Shadow插件，确认插件配置中包含了该依赖的模块。

4. 修正Log4J2配置文件的packages属性 #

看你提供的配置里，packages属性写的是com.amazonaws.services.lambda.runtime.log4j2.LambdaAppender，这是错误的！packages应该指定的是包路径，而不是具体类名。修改成：

<Configuration packages="com.amazonaws.services.lambda.runtime.log4j2">

这个小失误会导致Log4J2无法扫描到LambdaAppender类，从而抛出找不到类的错误。

按照这几个步骤排查下来，应该能解决你的问题。

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