Java Servlet文件下载代码触发HTTP 500错误，如何排查？

嘿，看来你在做Servlet文件下载功能时踩了NullPointerException的坑，报错明确指向p1.Download.doGet(Download.java:76)这一行。结合文件下载的常见场景，我帮你梳理下最可能的问题原因和排查方向：

常见触发空指针的场景（针对文件下载） #

• 文件/流对象未初始化：第76行大概率是在调用某个对象的方法，但这个对象是null。比如你用new File(filePath)创建文件对象，但filePath是null；或者通过getResourceAsStream()获取输入流时，路径错误导致流为null，后续调用read()就会抛空指针。
• 请求参数缺失：如果你的下载逻辑依赖前端传递的参数（比如文件名），比如request.getParameter("fileName")，但前端没传这个参数，拿到的是null，后续用这个null值去查找文件就会出问题。
• 资源路径错误：如果是读取项目内的资源文件，路径拼写错误或者资源实际不存在，会导致获取到的文件对象/流为null。

快速排查&修复建议 #

1. 定位第76行的具体代码：先看这一行到底在操作什么对象——是File、InputStream还是从请求里拿的参数？在这行前后加打印语句，输出相关变量的值，比如：

   // 假设第76行是操作inputStream，先打印看看
   System.out.println("当前输入流：" + inputStream);
   // 如果是依赖请求参数，打印参数值
   System.out.println("获取到的文件名：" + request.getParameter("fileName"));
   

2. 校验文件存在性与路径：如果是本地文件，确认filePath是否正确（相对路径要注意Tomcat的运行目录，建议用getServletContext().getRealPath()来获取绝对路径）；如果是项目内资源，确认文件是否放在正确的目录（比如WEB-INF下的话，直接用getResourceAsStream要注意路径写法）。
3. 参数合法性校验：在使用请求参数前，先判断是否为null或空字符串，比如：

   String fileName = request.getParameter("fileName");
   if (fileName == null || fileName.trim().isEmpty()) {
       response.sendError(HttpServletResponse.SC_BAD_REQUEST, "请传递文件名参数");
       return;
   }
   

4. 资源权限检查：偶尔会碰到文件存在但Tomcat进程没有读取权限的情况，这也可能导致获取流失败返回null，记得确认文件的读写权限。

给你一段标准的文件下载Servlet代码参考，你可以对比自己的代码看看哪里漏了校验：

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    // 1. 校验请求参数
    String fileName = request.getParameter("fileName");
    if (fileName == null || fileName.trim().isEmpty()) {
        response.sendError(HttpServletResponse.SC_BAD_REQUEST, "缺少必要的文件名参数");
        return;
    }

    // 2. 获取文件绝对路径，确保文件存在
    String fileRealPath = getServletContext().getRealPath("/downloads/" + fileName);
    File targetFile = new File(fileRealPath);
    if (!targetFile.exists() || !targetFile.isFile()) {
        response.sendError(HttpServletResponse.SC_NOT_FOUND, "请求的文件不存在");
        return;
    }

    // 3. 设置响应头，告诉浏览器这是下载文件
    response.setContentType(getServletContext().getMimeType(targetFile.getName()));
    response.setContentLength((int) targetFile.length());
    response.setHeader("Content-Disposition", "attachment; filename=\"" + URLEncoder.encode(fileName, "UTF-8") + "\"");

    // 4. 读写文件流，使用try-with-resources自动关闭流
    try (InputStream in = new FileInputStream(targetFile);
         OutputStream out = response.getOutputStream()) {
        byte[] buffer = new byte[4096];
        int bytesRead;
        while ((bytesRead = in.read(buffer)) != -1) {
            out.write(buffer, 0, bytesRead);
        }
    }
}

重点盯着第76行的对象，确认它在调用方法前已经被正确初始化，而且对应的资源确实存在，应该就能解决这个空指针问题啦。

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