Servlet文件上传代码编译报错：无法访问HttpServletRequest

1. 换用兼容Jakarta EE的commons-fileupload版本 #

commons-fileupload 1.4只支持旧的Java EE（javax.servlet包），你的代码用的是新的Jakarta EE（jakarta.servlet包），版本不兼容直接导致参数匹配错误。直接把commons-fileupload-1.4.jar换成commons-fileupload 2.0及以上版本，这个版本开始支持Jakarta API，同时保留commons-io-2.11.0.jar即可，版本兼容没问题。

2. 清理类路径里的冲突依赖 #

别手动把servlet-api.jar、jsp-api.jar加到类路径里，这些API包应该由你的Servlet容器（比如Tomcat、Jetty）提供：

• 如果用Tomcat 10+，它自带的是Jakarta版本的API（jakarta.servlet-api.jar），旧的servlet-api.jar和你代码里的jakarta.servlet包冲突，直接删掉类路径里的servlet-api.jar和jsp-api.jar。
• 如果用Maven/Gradle管理项目，直接加Jakarta Servlet API依赖，并且设为provided scope（容器会提供，不用打包进去）：
  Maven示例：

  <dependency>
      <groupId>jakarta.servlet</groupId>
      <artifactId>jakarta.servlet-api</artifactId>
      <version>6.0.0</version>
      <scope>provided</scope>
  </dependency>
  

3. 修正代码里的导入路径 #

确保代码里的Servlet类和文件上传类都用正确的包：

// 正确的Jakarta Servlet导入
import jakarta.servlet.http.HttpServletRequest;
// commons-fileupload 2.x的包路径
import org.apache.commons.fileupload2.servlet.ServletFileUpload;

这时ServletFileUpload.parseRequest(request)的参数就会匹配jakarta.servlet.http.HttpServletRequest，不会再报错。

4. 检查容器版本适配 #

如果你的容器是Tomcat 9及以下，它只支持旧的javax.servlet API，那你有两个选择：

• 把代码里的jakarta.servlet全部替换成javax.servlet，同时继续用commons-fileupload 1.4；
• 升级容器到Tomcat 10+，适配新的Jakarta API。

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