log4j到log4j2升级迁移方案
序：这段时间因为维护的项目存在大量日志打印，严重拖慢整体响应时间，在做性能优化的工作中对这块内容进行了升级换代，由以前的log4j升级为log4j2，以实现日志异步打印。接下来记录一下这个费时半个月的迁移踩过的坑！
相关操作步骤：
1. 在项目中移除log4j的依赖，并添加log4j2的相关依赖.(选择log4j2的版本时请留意，2.10.x之后的版本是基于java9的！如果有使用到某些特性，请考虑当前项目的jdk版本！)
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-web</artifactId>
<version>2.9.1</version>
</dependency>
<!-- https://mvnrepository.com/artifact/org.apache.logging.log4j/log4j-core -->
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
<version>2.9.1</version>
</dependency>
<!-- https://mvnrepository.com/artifact/org.apache.logging.log4j/log4j-api -->
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
<version>2.9.1</version>
</dependency>
我最开始使用的2.11.2版本，因为jdk原因退回到2.9.1(请注意如果你的项目是通过jenkins构建，请将api,core包的依赖直接添加进来！)
2.修改项目中所有的报错！(这些都是jar包替换造成的！注意log4j2在实现方面与log4j是有区别的，常用的3个为：自定义appender，自定义日志等级，获取logger的方式)
自定义appender方式：
@Plugin(
name = "CustomerAppender",
category = "Core",
elementType = "appender",
printObject = true
)
public final class CustomerAppender extends AbstractOutputStreamAppender<CustomerRollingFileManager> {
//TODO
//此部分为自定义内容
}
3.本文以maven依赖管理为例，查看dependencies树，确保项目中没有其他依赖的依赖引入log4j相关jar包
这个步骤自行解决～～举例如下：
<dependency>
<groupId>net.sourceforge.jexcelapi</groupId>
<artifactId>jxl</artifactId>
<version>2.6.12</version>
<exclusions>
<exclusion>
<artifactId>log4j</artifactId>
<groupId>log4j</groupId>
</exclusion>
</exclusions>
</dependency>
4.为步骤三中找到并移除的实现引入需要的桥接包！(此处注意大多数的项目中使用的 都是slf4j的框架,不同的版本使用Log4j2的实现需要的桥接包版本是不一样的！请仔细查看相关版本)
<!-- https://mvnrepository.com/artifact/org.slf4j/jcl-over-slf4j -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>jcl-over-slf4j</artifactId>
<version>x.x.x</version>
</dependency>
<!-- https://mvnrepository.com/artifact/org.apache.logging.log4j/log4j-slf4j-impl -->
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-slf4j-impl</artifactId>
<version>x.x.x</version>
</dependency>
请根据实际需要修改对应版本，建议在maven repository中查询版本对应关系
5.根据原有log4j.xml的配置文件改造log4j2.xml(原来通过java定义的日志等级可以迁移到此处)
<CustomLevels>
<CustomLevel name="BUSI" intLevel="350" />
</CustomLevels>
这里可以根据需要定义name，一级level,注意这个值与log4j定义的不太一样，具体请参考源码中的定义规则，我此处给的350在info等级以上
6.解决kafka日志推送问题.(log4j推送kafka一般是通过kafka-log4j-appender这个中间包去实现的,在lo4j2下需要更换推送方式,有内置的kafkaAppender，需要在依赖管理中根据需要推送的kafka服务端版本号添加对应的客户端版本号:kafka-clients)
<!--kafka日志推送-->
<Kafka name="kafkaAppender" topic="test" ignoreExceptions="true">
<PatternLayout pattern="${Console_Pattern}" />
<Property name="bootstrap.servers">x.x.x.x:端口号,x.x.x.x:端口号</Property>
<Property name="max.block.ms">2000</Property>
</Kafka>
此处还可以设置ignoreException=false;这个时候需要去对异常做处理，可以获取异常信息.
需要添加的kafka-clients依赖如下(请修改具体版本):
<!-- https://mvnrepository.com/artifact/org.apache.kafka/kafka-clients --> <dependency> <groupId>org.apache.kafka</groupId> <artifactId>kafka-clients</artifactId> <version>0.10.0.0</version> </dependency>
7.解决容器问题！这个并非所有的容器都需要（至少tomcat不需要。。）目前我们服务器端使用的为jboss。在对日志升级后有可能出现对应业务日志打印到jboss的server日志中！这肯定是不允许的！解决办法：在项目的WEB-INF或者META-INF目录下添加：jboss-deployment-structure.xml文件,注意此处放置的位置和文件名都必须是这个！这是jboos规定的。此文件的作用是可以管理jboss的相关依赖,可以在此处排除它的log4j2的实包
<?xml version="1.0" encoding="UTF-8" ?>
<jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.2">
<deployment>
<exclude-subsystems>
<!-- 排除 javax.persistence.api 依赖 -->
<subsystem name="jpa" />
<!-- 排除 org.jboss.logging 依赖 -->
<subsystem name="logging" />
</exclude-subsystems>
<exclusions>
<!-- 排除 org.apache.httpcomponents 依赖 -->
<module name="org.jboss.resteasy.resteasy-jaxrs" />
<!-- 排除 javax.persistence.api 依赖 -->
<module name="javaee.api" />
<module name="javax.persistence.api" />
<module name="org.hibernate" />
</exclusions>
<dependencies>
<!-- 排除 org.apache.httpcomponents 依赖 -->
<!-- <module name="org.apache.httpcomponents" export="true"/> -->
<!-- 排除 org.jboss.logging 依赖 -->
<!-- <module name="org.jboss.logging" export="true" /> --
<!-- 排除掉jboss的 slf4j 和 log4j 实现，使用我们程序自己的包 -->
<!--<module name="org.apache.log4j" export="true" />-->
<!--<module name="org.slf4j" export="true" />-->
<module name="org.apache.commons.logging" export="true" />
<module name="org.jboss.logging.jul-to-slf4j-stub" export="true" />
</dependencies>
</deployment>
</jboss-deployment-structure>
请根据项目实际需要做相关排除
8.解决因为包装自定义的logger导致的日志记录中不能正常记录logger打印位置的问题。（这个问题对于直接使用原生logger的项目不会有）在log4j2的api包下我们会发现没有提供可以传递FQCN的接口！所以此处我们需要直接引入core下的具体实现。在实现类中有log.logIfEnabled()方法，此方法允许传入(FQCN，level,maker,message).
import org.apache.logging.log4j.Level;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.core.Logger;
public abstract class AbstractABFrameLogger {
/** 线程栈查找方法深度 */
private final static int STACK_DEEP_SIZE = 2;
/** log4j把传递进来的callerFQCN在堆栈中一一比较，相等后，再往上一层即认为是用户的调用类 */
final static String FQCN = AbstractABFrameLogger.class.getName();
protected Logger log;
/**
*
* @param name name
*/
public AbstractABFrameLogger(String name) {
this.log = (Logger) LogManager.getLogger(name);
}
/**
* 基本debug基本,封装打印信息
* @param objLogInfo Object
*/
public void debug(Object objLogInfo) {
log.logIfEnabled(FQCN,Level.DEBUG,null,objLogInfo);
}
}
完成上述步骤后，整个log4j的升级工作也就差不多做完啦～恭喜
