文件上传后Servlet接收值为null的问题求助

当表单设置enctype="multipart/form-data"后，HTTP请求内容会以多部分二进制流的形式传输，原生的request.getParameter()方法无法解析这种格式的参数，这就是你获取字段值为null的根本原因。必须用专门的文件上传解析工具来提取普通表单字段和文件，以下是两种可行方案及排查要点：

方案1：使用Servlet 3.0+原生Part API（无需额外依赖） #

你的Tomcat 9/10.1版本完全支持该特性，步骤如下：

1. 给Servlet类添加@MultipartConfig注解（可配置文件大小限制，也可省略）：

@WebServlet("/ServletFileUpload")
@MultipartConfig(
    fileSizeThreshold = 1024 * 1024 * 2, // 2MB阈值，超过则写入磁盘
    maxFileSize = 1024 * 1024 * 10,      // 单文件最大10MB
    maxRequestSize = 1024 * 1024 * 50    // 整个请求最大50MB
)
public class ServletFileUpload extends HttpServlet {
    // 业务逻辑
}

2. 在doPost方法中通过request.getPart()提取字段和文件：

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    // 获取普通表单字段
    String name = getFormFieldValue(request, "name");
    String expirationDate = getFormFieldValue(request, "expirationDate");
    String category = getFormFieldValue(request, "category");

    // 处理上传文件
    Part filePart = request.getPart("file"); // 对应表单file输入框的name属性
    String fileName = filePart.getSubmittedFileName();
    filePart.write("/指定服务器存储路径/" + fileName);
}

// 封装工具方法读取普通字段值
private String getFormFieldValue(HttpServletRequest request, String fieldName) throws IOException, ServletException {
    Part part = request.getPart(fieldName);
    if (part == null) return null;
    try (InputStream is = part.getInputStream();
         BufferedReader reader = new BufferedReader(new InputStreamReader(is))) {
        return reader.readLine();
    }
}

方案2：使用Apache Commons FileUpload（兼容旧版Servlet） #

如果需要适配更低版本Servlet，或已引入该依赖：

1. 确保项目依赖完整（Maven示例）：

<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.5</version>
</dependency>
<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.15.1</version>
</dependency>

2. 在Servlet中解析请求：

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    DiskFileItemFactory factory = new DiskFileItemFactory();
    ServletFileUpload upload = new ServletFileUpload(factory);

    try {
        List<FileItem> items = upload.parseRequest(request);
        for (FileItem item : items) {
            if (item.isFormField()) {
                // 处理普通字段，指定编码避免乱码
                String fieldName = item.getFieldName();
                String fieldValue = item.getString("UTF-8");
                switch (fieldName) {
                    case "name":
                        String name = fieldValue;
                        break;
                    case "expirationDate":
                        String expirationDate = fieldValue;
                        break;
                    case "category":
                        String category = fieldValue;
                        break;
                }
            } else {
                // 处理上传文件
                String fileName = item.getName();
                item.write(new File("/指定服务器存储路径/" + fileName));
            }
        }
    } catch (Exception e) {
        e.printStackTrace();
    }
}

额外排查要点 #

• 检查表单中普通字段的name属性是否与Servlet中获取的字段名完全一致（大小写敏感）
• 确认表单method为POST，且Servlet的doPost方法被正确触发
• 若使用Servlet 3.0+ API，确保web.xml中<web-app>的版本为3.0及以上（如Tomcat 9对应version="4.0"）

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