Spring Boot图片上传API本地正常，Tomcat部署WAR包报文件不存在错误

嗨，我之前做类似的多文件上传API时也踩过这个坑，咱们一步步来分析解决～

首先，这个错误的核心原因是本地开发环境和Tomcat服务器的工作目录不一致，再加上可能的路径硬编码问题，导致程序找不到指定的文件路径。下面是具体的排查点和解决方案：

1. 放弃相对路径，改用可配置的绝对路径 #

本地开发时，Spring Boot的工作目录是你的项目根目录，所以images\logo1.png能找到项目根下的images文件夹。但部署到Tomcat后，Tomcat的工作目录是它自身的bin目录（或webapps下的应用目录），这时候相对路径指向的位置根本不存在。

解决方案：
在application.properties（或application.yml）里配置一个绝对路径，让代码读取这个配置来存储文件：

# 服务器上的文件存储目录，根据实际路径修改
file.upload.dir=D:/tomcat/uploaded_images
# 本地测试时可以用相对路径（部署服务器时一定要改成绝对路径）
# file.upload.dir=./src/main/resources/static/images

然后在上传处理类里注入这个配置，用它构建文件路径：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardCopyOption;

@RestController
public class UploadController {

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

    @PostMapping("/upload")
    public String uploadImage(@RequestParam("file") MultipartFile file) {
        try {
            // 构建目标文件路径，自动适配系统分隔符
            Path filePath = Paths.get(uploadDir, file.getOriginalFilename());
            // 确保父目录存在（不存在则自动创建）
            Files.createDirectories(filePath.getParent());
            // 写入文件到目标路径
            Files.copy(file.getInputStream(), filePath, StandardCopyOption.REPLACE_EXISTING);
            return "上传成功：" + filePath.toString();
        } catch (Exception e) {
            e.printStackTrace();
            return "上传失败：" + e.getMessage();
        }
    }
}

2. 避免硬编码路径分隔符 #

你代码里用了Windows专属的\作为路径分隔符，如果服务器是Linux系统（很多生产环境用Linux），会直接导致路径错误；就算服务器是Windows，硬编码分隔符也不是最佳实践。

解决方案：
用Java的Paths.get()方法拼接路径，它会自动适配当前系统的路径分隔符：

// 错误写法：硬编码Windows分隔符
// Path filePath = Paths.get("images\\logo1.png");

// 正确写法：自动适配系统分隔符
Path filePath = Paths.get(uploadDir, "logo1.png");

3. 检查Tomcat的权限问题 #

有时候报错NoSuchFileException并不是路径不存在，而是Tomcat的运行用户没有权限创建目录或写入文件。

解决方案：

• 确保配置的file.upload.dir目录存在，代码里通过Files.createDirectories()主动创建父目录（上面的代码已经包含这一步）。
• 给Tomcat运行用户分配该目录的读写权限：Windows下右键目录→属性→安全→添加Tomcat用户并赋予权限；Linux下用chown或chmod命令设置权限。

最后提醒 #

Spring Boot嵌入式Tomcat和外部Tomcat的运行环境差异很大，永远不要依赖System.getProperty("user.dir")这种获取当前工作目录的方式存储文件，一定要用可配置的绝对路径，这样本地测试和服务器部署都能灵活调整。

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