如何在Eclipse中修复HTTP 500错误？附Log4J Web应用代码

兄弟，我之前在Servlet里折腾Log4J的时候也踩过一模一样的500坑，结合你给出的代码片段，咱们一步步排查解决：

1. 先确认Log4J依赖是否到位 #

这是最常见的坑！如果你的项目里没正确引入Log4J的jar包，服务器会直接抛出ClassNotFoundException，触发500错误：

• 如果你用Maven，把这段依赖加到pom.xml里（对应你用的log4j 1.x版本）：

<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

• 如果是手动导包，一定要把log4j-1.2.x.jar放到项目的WEB-INF/lib目录下，缺了它一切白搭。

2. 修正Log4J的初始化时机 #

看你的代码里应该是在请求方法（比如doGet/doPost）里调用BasicConfigurator.configure()？这会导致每次请求都重复初始化Log4J，很容易引发配置冲突。正确的做法是在Servlet的init()方法里只初始化一次：

@Override
public void init() throws ServletException {
    super.init();
    // 只初始化一次Log4J基础配置
    BasicConfigurator.configure();
    Logger.getRootLogger().setLevel(Level.INFO);
}

3. 检查Logger实例的声明是否正确 #

Logger应该在类级别声明为静态常量，不要在方法里每次新建：

// 放在类的最顶部，替换成你的Servlet类名
private static final Logger logger = Logger.getLogger(Log4jTestServlet.class);

这样能避免重复初始化带来的异常，也符合Log4J的最佳实践。

4. 去服务器日志里找具体错误原因 #

HTTP 500只是个笼统的错误提示，真正的问题藏在服务器的日志里：

• 比如Tomcat的话，去Tomcat安装目录/logs下找catalina.out或者localhost.log，里面会有完整的异常栈信息，比如是依赖缺失、空指针还是配置错误，看了日志就能精准定位。

5. 确认Servlet的配置没问题 #

你用了@WebServlet注解，要确保：

• 注解里的URL映射正确，比如@WebServlet("/Log4jTest")，访问的时候要对应这个路径；
• 你的服务器支持Servlet 3.0+（比如Tomcat 7及以上），老版本服务器不支持注解，得去web.xml里手动配置Servlet。

给你一个完整的可运行示例代码 #

参考这个调整你的代码：

package tot;

import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.log4j.BasicConfigurator;
import org.apache.log4j.Level;
import org.apache.log4j.Logger;

@WebServlet("/Log4jTestServlet")
public class Log4jTestServlet extends HttpServlet {
    private static final long serialVersionUID = 1L;
    private static final Logger logger = Logger.getLogger(Log4jTestServlet.class);

    @Override
    public void init() throws ServletException {
        super.init();
        // 初始化Log4J基础配置
        BasicConfigurator.configure();
        logger.setLevel(Level.DEBUG);
    }

    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        response.setContentType("text/html");
        PrintWriter out = response.getWriter();
        
        // 测试Log4J输出
        logger.debug("这是DEBUG级别的日志");
        logger.info("这是INFO级别的日志");
        logger.warn("这是WARN级别的日志");
        
        out.println("Log4J测试完成，去服务器日志里查看输出吧！");
        out.close();
    }

    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        doGet(request, response);
    }
}

先去看服务器日志找具体异常，再对应上面的步骤排查，应该很快就能解决问题！

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