Tomcat 8.0.36未加载应用log4j.properties问题及解决方案咨询

针对你遇到的log4j 1.2.17配置文件不被Tomcat识别的问题，我整理了几个关键的排查和解决步骤，帮你搞定这个问题：

一、先排查基础配置问题 #

首先先把最容易踩的坑排除掉：

• 移除WEB-INF/lib下的log4j.properties：这个目录是放jar包的，log4j不会从这里加载配置文件，反而可能造成混淆，先删掉它，只保留WEB-INF/classes下的配置文件。
• 确认log4j jar包的位置：确保你的log4j-1.2.17.jar只放在应用的WEB-INF/lib目录下，不要在Tomcat的全局$CATALINA_HOME/lib或$CATALINA_BASE/lib里放其他版本的log4j包——Tomcat的类加载机制会优先加载全局lib的类，导致应用自己的log4j和配置被覆盖。

二、强制指定应用加载自己的log4j配置 #

如果上面的步骤没解决问题，建议在web.xml里显式配置log4j的初始化，确保应用启动时就加载你指定的配置：

方案1：用Spring的Log4jConfigListener（如果你的应用用Spring） #

<context-param>
    <param-name>log4jConfigLocation</param-name>
    <!-- 这里指定配置文件的路径，WEB-INF/classes下的文件可以直接用类路径写法 -->
    <param-value>classpath:log4j.properties</param-value>
</context-param>
<listener>
    <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
</listener>

方案2：自定义初始化Listener（不用Spring的情况） #

自己写一个ServletContextListener，在应用启动时手动加载配置：

import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import org.apache.log4j.PropertyConfigurator;

public class Log4jInitListener implements ServletContextListener {
    @Override
    public void contextInitialized(ServletContextEvent event) {
        // 获取应用的类路径下的配置文件
        String configPath = event.getServletContext().getRealPath("/WEB-INF/classes/log4j.properties");
        PropertyConfigurator.configure(configPath);
    }

    @Override
    public void contextDestroyed(ServletContextEvent event) {
        // 可选：清理log4j资源
    }
}

然后在web.xml里注册这个Listener：

<listener>
    <listener-class>com.yourpackage.Log4jInitListener</listener-class>
</listener>

三、找到Tomcat当前使用的log4j配置文件 #

想确认Tomcat到底在加载哪个配置，有两个简单的方法：

1. 在代码里打印配置路径：在应用的初始化代码（比如Servlet或Listener里）加一段代码，输出当前log4j使用的配置文件路径：

import org.apache.log4j.Logger;
import java.net.URL;

// 比如在上面的自定义Listener里添加
Logger rootLogger = Logger.getRootLogger();
URL configUrl = rootLogger.getRepository().getConfiguration().getResource();
if (configUrl != null) {
    System.out.println("当前生效的log4j配置文件：" + configUrl.getPath());
} else {
    System.out.println("未加载自定义配置，使用log4j默认配置");
}

2. 开启log4j调试模式：启动Tomcat时添加JVM参数-Dlog4j.debug=true，这样log4j会在控制台输出详细的加载日志，包括它尝试加载的所有配置文件路径、加载是否成功，最终选定的配置文件是什么。

四、确保应用配置优先加载的关键 #

Tomcat的类加载遵循Web应用优先的原则，但要注意两个点：

• 不要在Tomcat全局lib目录下放log4j的jar包，否则全局的log4j会先被加载，应用自己的配置就可能不生效。
• 如果必须保留全局log4j，那要确保全局版本和应用内的log4j-1.2.17.jar版本完全一致，并且通过JVM参数-Dlog4j.configuration=file:/path/to/your/webapp/WEB-INF/classes/log4j.properties强制指定配置文件，但这种方式会影响所有部署在Tomcat上的应用，不推荐。

最后检查小细节 #

• 确认配置文件名拼写正确：是log4j.properties，不是log4j.propertie或者其他拼写错误。
• 检查配置文件语法：比如log4j.rootLogger=INFO, Console这种格式是否正确，有没有遗漏逗号、写错appender名称等。
• 配置文件编码：如果里面有中文日志内容，确保文件是UTF-8编码，避免解析乱码。

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