Apache Commons FileUpload新Servlet仅获文本参数，无法读取文件项求助

• 检查Postman请求配置

  • 确认请求的Content-Type为multipart/form-data，不要误选成application/x-www-form-urlencoded或其他类型
  • 确保file类型参数的类型选择为「File」而非「Text」，且已正确选择本地文件，参数值不为空
  • 核对表单参数的字段名与代码中判断逻辑的一致性，避免拼写错误

• 核对Servlet部署配置

  • 对比新旧Servlet的web.xml配置，确认新Servlet的<servlet>和<servlet-mapping>映射路径正确，没有冲突
  • 检查是否存在拦截该Servlet请求的过滤器（Filter），部分过滤器会提前读取request输入流，导致ServletFileUpload无法解析文件内容
  • 确认新Servlet正确重写了doPost方法，未误写为doGet，也未在doPost中调用父类doPost方法导致请求被提前处理

• 验证Commons FileUpload依赖

  • 确保lib目录下commons-fileupload.jar和commons-io.jar的版本与旧Servlet使用的一致，Java 1.6适配的FileUpload版本建议为1.2.x系列（如1.2.2），高版本可能存在兼容性问题
  • 检查lib目录是否存在多版本的commons-fileupload或commons-io jar包，避免版本冲突

• 添加调试日志定位问题

  • 在新Servlet中打印req.getContentType()，确认请求确实为multipart/form-data类型
  • 遍历items时，打印每个item的fieldName()、isFormField()状态，查看file类型参数是否被错误识别为普通表单字段
  • 打印req.getContentLength()，确认请求内容长度是否符合预期，是否包含文件数据

• 检查服务器端上传限制

  • 查看服务器（如Tomcat 6.x）配置，确认conf/server.xml中的maxPostSize参数值合理，默认2MB，若上传文件超过该值会被截断
  • 检查DiskFileItemFactory的配置，是否设置了正确的临时文件存储路径和缓存大小，例如：

    DiskFileItemFactory factory = new DiskFileItemFactory();
    factory.setSizeThreshold(1024 * 1024); // 设置1MB内存缓存
    factory.setRepository(new File(System.getProperty("java.io.tmpdir"))); // 指定临时文件目录
    

    旧Servlet可能有这些配置，新Servlet复制时可能遗漏

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