Jetty上传后临时Multipart文件未自动删除问题求助

核心排查与解决方向 #

• Multipart资源未正确释放
  使用MultipartFile时，必须确保流资源被正确关闭。如果仅读取流但未关闭，Jetty关联的临时文件引用无法被GC回收，导致文件残留。正确做法是用try-with-resources自动管理流：

  try (InputStream is = multipartFile.getInputStream()) {
      // 业务处理逻辑
  }
  

  若自定义了MultipartResolver，需确认cleanupMultipart()方法在请求结束后被调用——Spring Boot默认会自动执行，但异步请求或自定义流程中可能需要手动触发。

• Jetty临时存储配置问题
  Jetty 12的Multipart临时文件由TempFileFactory控制，检查是否存在以下配置问题：

  • 自定义TempFileFactory时设置了deleteOnExit=false
  • 指定的临时目录权限不足，Jetty进程无法删除文件
    可通过Spring Boot配置调整参数：

  server.jetty.multipart.cleanup-after-request=true
  server.jetty.multipart.temp-dir=/path/to/writable/temp-folder
  

  确保临时目录具备读写权限，且Jetty进程拥有删除文件的权限。

• 异常中断导致的残留
  上传过程中客户端断开、服务器抛出异常时，Jetty自动清理逻辑可能未触发。可添加全局异常处理器，手动清理异常请求的临时文件：

  @ControllerAdvice
  public class MultipartExceptionHandler {
      @ExceptionHandler(MultipartException.class)
      public ResponseEntity<String> handleMultipartError(HttpServletRequest request) {
          if (request instanceof MultipartHttpServletRequest multipartReq) {
              multipartReq.getFileMap().values().forEach(file -> {
                  try {
                      File tempFile = ((CommonsMultipartFile) file).getFile();
                      if (tempFile != null && tempFile.exists()) {
                          tempFile.delete();
                      }
                  } catch (Exception e) {
                      // 记录清理失败日志
                  }
              });
          }
          return ResponseEntity.badRequest().body("上传异常，已清理临时文件");
      }
  }
  

• GC回收延迟
  Jetty临时文件通过弱引用关联，只有当MultipartFile实例被GC回收后，文件才会被删除。若应用存在内存泄漏，导致Multipart对象无法回收，会引发文件残留。可通过jmap、jconsole等工具排查内存中是否有大量未回收的MultipartFile实例。

临时应急方案 #

磁盘空间紧急时，可添加定时任务清理超时的Jetty临时文件：

@Scheduled(fixedRate = 3600000) // 每小时执行一次
public void cleanExpiredTempFiles() {
    File tempDir = new File(System.getProperty("java.io.tmpdir"));
    File[] expiredFiles = tempDir.listFiles(file -> 
        file.getName().startsWith("jetty-") 
        && file.lastModified() < System.currentTimeMillis() - 3600000
    );
    if (expiredFiles != null) {
        for (File file : expiredFiles) {
            file.delete();
        }
    }
}

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