添加依赖后部署Lambda仍报Console含无效元素JsonTemplateLayout求助

问题表现 #

Spring Boot项目中使用Log4j2，配置了包含JsonTemplateLayout的log4j.xml，已添加log4j-layout-template-json依赖并尝试过不同版本。本地运行正常，但部署到AWS Lambda后，CloudWatch报错：

Console contains an invalid element or attribute "JsonTemplateLayout"

相关配置文件 #

log4j.xml

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
    <Appenders>
        <Console name="JsonAppender" target="SYSTEM_OUT">
            <JsonTemplateLayout eventTemplateUri="classpath:LambdaJsonLayout.json" />
        </Console>
    </Appenders>
    <Loggers>
        <Logger name="JsonLogger" level="INFO" additivity="false">
            <AppenderRef ref="JsonAppender"/>
        </Logger>
        <Root level="info">
            <AppenderRef ref="JsonAppender"/>
        </Root>
    </Loggers>
</Configuration>

pom.xml（原关键片段）

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.7</version>
</parent>

<properties>
    <log4j.version>2.19.0</log4j.version>
</properties>

<dependencies>
    <!-- Log4j2依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-log4j2</artifactId>
        <version>2.6.6</version> <!-- 与parent版本不一致 -->
    </dependency>
    <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-api</artifactId>
        <version>${log4j.version}</version>
    </dependency>
    <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-core</artifactId>
        <version>${log4j.version}</version>
    </dependency>
    <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-layout-template-json</artifactId>
        <version>2.18.0</version> <!-- 与core版本不一致 -->
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <configuration>
                <filters>
                    <filter>
                        <artifact>*:*</artifact>
                        <excludes>
                            <exclude>**/Log4j2Plugins.dat</exclude> <!-- 排除了扩展注册关键文件 -->
                        </excludes>
                    </filter>
                </filters>
            </configuration>
        </plugin>
    </plugins>
</build>

核心原因 #

1. Log4j2组件版本不兼容：log4j-core与log4j-layout-template-json版本不一致，导致扩展组件无法被识别。
2. Spring Boot依赖版本冲突：spring-boot-starter-log4j2版本与parent版本不匹配，引入了不兼容的底层依赖。
3. Shade插件配置错误：排除了Log4j2Plugins.dat文件，该文件是Log4j2发现扩展组件的核心注册文件，Lambda环境下无法加载JsonTemplateLayout。
4. 资源文件可能未正确打包：LambdaJsonLayout.json未被包含在最终jar包中，导致布局模板加载失败。

解决方案 #

1. 统一Log4j2组件版本 #

将log4j-layout-template-json版本改为与log4j-core/log4j-api一致：

<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-layout-template-json</artifactId>
    <version>${log4j.version}</version> <!-- 统一为2.19.0 -->
</dependency>

2. 对齐Spring Boot Log4j2 Starter版本 #

删除spring-boot-starter-log4j2的手动版本指定，让parent自动管理匹配版本：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-log4j2</artifactId>
    <!-- 移除version，使用parent的2.7.7对应版本 -->
</dependency>

3. 修改Shade插件配置 #

保留并合并Log4j2Plugins.dat文件，添加转换器确保扩展注册信息正确合并：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.4.0</version>
    <configuration>
        <createDependencyReducedPom>false</createDependencyReducedPom>
        <filters>
            <filter>
                <artifact>*:*</artifact>
                <excludes>
                    <!-- 移除对Log4j2Plugins.dat的排除 -->
                </excludes>
            </filter>
        </filters>
        <!-- 添加转换器合并Log4j2扩展注册文件 -->
        <transformers>
            <transformer implementation="org.apache.maven.plugins.shade.resource.Log4j2PluginsDatTransformer"/>
        </transformers>
    </configuration>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
        </execution>
    </executions>
</plugin>

4. 确保资源文件正确打包 #

确认LambdaJsonLayout.json放在项目src/main/resources目录下，maven打包时会自动包含到jar中。

验证步骤 #

1. 执行mvn clean package，检查jar包内是否包含Log4j2Plugins.dat和LambdaJsonLayout.json。
2. 重新部署到AWS Lambda，触发函数查看CloudWatch日志是否正常输出JSON格式内容。

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