Spring Boot从Tomcat迁移Jetty：缺失异常类替代方案咨询

核心原则 #

避免直接依赖Tomcat或Jetty的内部API，优先使用Spring或Servlet规范提供的抽象层，这样切换服务器时无需大量修改代码。

1. 处理文件上传异常（FileUploadException） #

• 替换Tomcat的org.apache.tomcat.util.http.fileupload.FileUploadException为Spring统一封装的org.springframework.web.multipart.MultipartException。这是Spring Web模块对文件上传异常的通用处理类，无论使用Tomcat还是Jetty，文件上传失败时都会抛出该异常，完全兼容跨服务器场景。
• 若需更细粒度处理，Jetty底层同样基于Apache Commons FileUpload，会抛出org.apache.commons.fileupload.FileUploadException，但仍建议优先使用Spring的MultipartException，避免绑定到具体组件。

2. 处理客户端中断异常（ClientAbortException） #

• Tomcat的org.apache.catalina.connector.ClientAbortException对应Jetty的org.eclipse.jetty.io.EofException，当客户端提前断开连接时，Jetty会抛出该异常。
• 更通用的做法是捕获Servlet规范层面的javax.servlet.ServletException（Jetty会将EofException包装在此异常内）或直接捕获IOException子类，这样代码在Tomcat和Jetty下都能正常运行。

通用迁移注意事项 #

• 全局排查代码中所有org.apache.tomcat.*包的直接引用，替换为Spring或Servlet API的对应类。例如用javax.servlet.http.HttpServletRequest替代Tomcat的具体实现类。
• 确保项目依赖正确切换，排除Tomcat依赖并引入Jetty：
  Maven示例：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
      <exclusions>
          <exclusion>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-starter-tomcat</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-jetty</artifactId>
  </dependency>
  

  Gradle示例：

  dependencies {
      implementation 'org.springframework.boot:spring-boot-starter-web'
      implementation 'org.springframework.boot:spring-boot-starter-jetty'
      // Gradle会自动处理依赖冲突，若有显式Tomcat依赖可手动排除
  }
  

• 重点测试文件上传、客户端中断、大请求处理等场景，验证异常逻辑在Jetty下的正确性。
• 若必须处理Jetty特有异常，仅在必要时引入Jetty API依赖，避免过度绑定到Jetty实现。

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