Spring Boot文件上传功能在Tomcat+Ubuntu生产服务器失效求助

核心问题分析 #

从代码逻辑与部署环境差异来看，失效原因集中在目录路径权限、循环逻辑错误、Tomcat上传限制这几个关键点：

1. 目录路径与权限问题 #

代码中使用System.getProperty("user.dir")作为上传目录的基础路径：

• Windows开发环境下，该路径指向项目根目录，权限充足；
• Ubuntu的Tomcat环境中，user.dir实际是Tomcat的启动目录（如/opt/tomcat/bin），Tomcat进程通常没有该目录下创建子目录的权限，且这种路径不符合服务器规范。
  同时目录创建时仅捕获异常但未处理，权限不足时直接跳过，后续文件复制必然失败。

2. 循环逻辑错误 #

检查文件是否上传的循环中，始终判断multipartFile[0]而非当前索引i的文件：

if(multipartFile[0].getOriginalFilename().equals("")) {
    imageNotUploaded = true;
}

这会导致只要第一个文件为空，就判定为未上传，忽略其他文件的实际情况，属于逻辑错误。

3. Tomcat默认上传限制 #

Tomcat默认单文件上传限制为2MB、总请求大小10MB，若上传图片超出该限制，会直接拒绝请求且无明确错误提示。

修复步骤 #

1. 修正目录路径与权限 #

• 替换硬编码路径，改用Spring Boot配置指定上传目录：
  在application.properties中添加：

  file.upload-dir=/var/lib/tomcat8/webapps/user-photos
  

  代码中注入配置：

  @Value("${file.upload-dir}")
  private String uploadDir;
  

• 在Ubuntu服务器创建目录并赋予Tomcat权限：

  sudo mkdir -p /var/lib/tomcat8/webapps/user-photos
  sudo chown -R tomcat8:tomcat8 /var/lib/tomcat8/webapps/user-photos
  sudo chmod -R 755 /var/lib/tomcat8/webapps/user-photos
  

• 优化目录创建的异常处理，添加用户提示：

  if (!Files.exists(uploadPath)) {
      try {
          Files.createDirectories(uploadPath);
      } catch (Exception e) {
          modelAndView.addObject("error", "无法创建上传目录，请联系管理员");
          modelAndView.setViewName("SubCategory_1_1");
          return modelAndView;
      }
  }
  

2. 修正循环逻辑错误 #

将空文件判断改为当前索引i，并使用更严谨的isEmpty()方法：

if(multipartFile[i].isEmpty()) {
    imageNotUploaded = true;
}

3. 调整Tomcat文件上传限制 #

• 方式一：修改Tomcat的conf/web.xml，添加或更新multipart-config：

  <multipart-config>
      <max-file-size>10485760</max-file-size> <!-- 10MB -->
      <max-request-size>52428800</max-request-size> <!-- 50MB -->
      <file-size-threshold>0</file-size-threshold>
  </multipart-config>
  

• 方式二：在Spring Boot的application.properties中配置：

  spring.servlet.multipart.max-file-size=10MB
  spring.servlet.multipart.max-request-size=50MB
  

4. 优化文件类型校验 #

仅通过文件名后缀判断存在风险，建议结合MIME类型校验：

String contentType = multipartFile[i].getContentType();
List<String> supportedMimeTypes = Arrays.asList("image/png", "image/jpeg", "image/gif", "image/webp");
if(!supportedMimeTypes.contains(contentType)) {
    unSupportedFileType = true;
}

额外排查点 #

• 查看Tomcat日志（/var/lib/tomcat8/logs/catalina.out），确认是否有权限、IO异常等错误信息；
• 检查Ubuntu防火墙/安全组是否拦截了文件上传的POST请求。

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