Tomcat10 Servlet中jQuery Ajax提交FormData时request.getParameter返回null

问题根源 #

当使用FormData通过jQuery Ajax提交请求时，请求的Content-Type会被自动设置为multipart/form-data，而request.getParameter()方法仅支持解析application/x-www-form-urlencoded编码的表单参数。对于multipart/form-data类型的请求，Tomcat不会自动将参数填充到请求的parameter map中，因此直接调用request.getParameter()会返回null，但请求体中确实包含参数内容。

解决方案 #

根据是否需要上传文件，分两种场景处理：

场景1：仅提交普通表单数据（无文件上传） #

如果不需要上传文件，无需使用FormData，直接序列化表单即可让请求采用application/x-www-form-urlencoded编码，这样request.getParameter()就能正常获取参数：

// 直接序列化表单提交
$.ajax({
    url: "YourServlet",
    type: "POST",
    data: $("#yourFormId").serialize(),
    success: function(response) {
        // 处理响应逻辑
    }
});

场景2：需要上传文件（必须使用FormData） #

若涉及文件上传，必须使用FormData，此时需通过Servlet 3.0+的multipart解析API处理：

1. 给Servlet添加@MultipartConfig注解
   告诉Tomcat当前Servlet需要处理multipart/form-data类型的请求：

   @WebServlet("/YourServlet")
   @MultipartConfig // 关键注解，必须添加
   public class YourServlet extends HttpServlet {
       @Override
       protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
           // 获取普通表单参数
           String username = request.getParameter("username");
           // 获取上传的文件
           Part filePart = request.getPart("avatar");
           
           // 处理参数和文件的逻辑...
       }
   }
   

2. 修正jQuery Ajax代码
   确保Ajax请求不破坏FormData的结构，需设置两个关键参数：

   var formData = new FormData($("#yourFormId")[0]);
   $.ajax({
       url: "YourServlet",
       type: "POST",
       data: formData,
       processData: false, // 禁止jQuery序列化FormData
       contentType: false, // 禁止手动设置Content-Type，让jQuery自动生成带boundary的正确头
       success: function(response) {
           // 处理响应逻辑
       }
   });
   

   注意：不要手动设置contentType: "multipart/form-data"，否则会丢失请求头中的boundary参数，导致Tomcat无法正确解析请求体。

关键注意事项 #

• request.getParameter()仅适用于application/x-www-form-urlencoded或已解析的multipart/form-data请求（需加@MultipartConfig）。
• 使用FormData时，必须保证processData: false和contentType: false，否则会破坏请求结构。

内容的提问来源于stack exchange，提问作者Param-Ganak