如何将Log4j v1的Appender class属性迁移适配到Log4j v2？

• Log4j v1配置中Appender的'class'选项是否为必填项？
  是必填项。Log4j v1没有内置的Appender类型推断机制，无论是properties格式还是XML格式配置，必须通过全限定类名明确指定Appender的实现类：properties格式要求固定以log4j.appender.<appender名称>=全限定类名作为Appender声明的首行，XML格式要求<appender>标签必须携带class属性填写全限定类名，缺失该配置会直接抛出初始化错误，无法加载对应Appender。

• Log4j v2配置中Appender的'class'选项是否为必填项？
  不是必填项。99%的常规使用场景下，完全不需要手动配置class属性。

• Log4j v2不配置class时，如何定位实际的Appender实现类？
  Log4j v2重构了基于注解的插件注册机制，从根本上替代了v1靠全限定类名加载组件的逻辑：

  • 所有官方内置Appender、第三方自定义Appender，实现类上都会标记@Plugin注解，注解中会明确声明该Appender对应的插件名称、组件类型（Appender类）
  • Log4j v2启动时会自动扫描classpath下所有带@Plugin注解的类，建立「插件名称 -> 对应实现类」的全局映射表
  • 解析配置时，XML格式直接以标签名作为插件名匹配映射表，properties/JSON/YAML等非标签格式通过type字段填写插件名匹配映射表，即可直接定位到需要实例化的Appender实现类，不需要用户手动填写全限定类名。
    官方迁移示例中看到的<File>标签，对应的就是插件名为File的内置FileAppender实现，启动时会自动匹配到org.apache.logging.log4j.core.appender.FileAppender类完成实例化。

• Log4j v2的XML配置中如何实现v1 'class'属性的等效配置？
  分两种场景处理：

  • 常规场景（使用官方内置Appender、已正确注册插件的第三方Appender）：直接使用插件名作为标签名即可，无需额外配置class。比如原配置中org.apache.log4j.ConsoleAppender对应的v2实现插件名为Console，直接写<Console name="CONSOLE">即可完成等效声明，比v1的全限定类名配置更简洁。
  • 特殊兜底场景（自定义Appender未加注解、插件扫描未覆盖到对应类）：可以直接在Appender标签上添加class属性，填写目标实现类的全限定名即可，v2会直接加载该类完成实例化，效果和v1的class属性完全一致。注意v2和v1的Appender接口包路径、实现逻辑完全不兼容，不要直接填写v1版本的Appender全限定类名。

原配置迁移示例 #

持有的v1 properties配置行：

log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender

对应的最简v2 XML配置片段为：

<Appenders>
  <!-- 直接用Console作为标签名，自动匹配内置ConsoleAppender实现 -->
  <Console name="CONSOLE" target="SYSTEM_OUT">
    <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
  </Console>
</Appenders>

如果需要手动指定类名兜底，写法如下（非必要不推荐）：

<Appenders>
  <appender name="CONSOLE" class="org.apache.logging.log4j.core.appender.ConsoleAppender">
    <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
  </appender>
</Appenders>

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