Spring Boot图片上传遇NoSuchFileException：图片文件夹应放何处？

首先得明确报错的根源：你用servletContext.getRealPath()获取的是Tomcat运行时生成的临时文档根目录（就是报错信息里的/private/var/folders/.../tomcat-docbase...），这个目录是动态创建的，你项目里myApp/src/web/images的文件夹并不会自动同步到这里，所以写入文件时系统找不到对应的images文件夹，就抛出了NoSuchFileException。

下面给你两个实用的解决方案：

方案一：使用项目外部的持久化目录（生产环境推荐） #

把上传的图片存到项目之外的固定目录，这样不管项目怎么部署、重启，文件都不会丢失，也完全不受容器临时目录的影响。

1. 先创建一个外部目录，比如/opt/myApp/upload/images（Linux/Mac）或者C:\myApp\upload\images（Windows）。
2. 在application.properties里配置这个路径，方便后续修改：

app.upload.image-path=/opt/myApp/upload/images

3. 修改你的saveFile方法，注入配置的路径，并且确保目标目录存在（不存在就自动创建）：

import org.springframework.beans.factory.annotation.Value;
import javax.servlet.ServletContext;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

public class YourFileUploadService {

    @Value("${app.upload.image-path}")
    private String imageBasePath;

    private String saveFile(MultipartFile file, String fileName) throws IOException {
        // 先确保目标目录存在
        Path targetDir = Paths.get(imageBasePath);
        if (!Files.exists(targetDir)) {
            Files.createDirectories(targetDir);
        }
        // 拼接完整文件路径
        Path filePath = targetDir.resolve(fileName);
        // 写入文件
        Files.write(filePath, file.getBytes());
        // 如果需要返回前端可访问的URL，后续配置静态资源映射后可以返回"/images/" + fileName
        return filePath.toString();
    }
}

4. 配置静态资源映射，让前端能访问到这些外部目录里的图片。创建一个WebMvcConfig类：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    @Value("${app.upload.image-path}")
    private String imageBasePath;

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 把外部目录映射到URL的/images/**路径
        registry.addResourceHandler("/images/**")
                .addResourceLocations("file:" + imageBasePath + "/");
    }
}

方案二：本地开发环境的临时方案（仅用于测试） #

如果你只是在本地开发测试，不想折腾外部目录，可以把images文件夹放到src/main/resources/static目录下（Spring Boot默认的静态资源目录）。但要注意：打包成Jar包后，这个目录是只读的，无法写入，所以只适合开发阶段用。

修改代码时，放弃使用getRealPath()，直接操作本地目录：

private String saveFile(MultipartFile file, String fileName) throws IOException {
    String imageDirPath = "src/main/resources/static/images";
    Path dirPath = Paths.get(imageDirPath);
    // 先创建目录
    if (!Files.exists(dirPath)) {
        Files.createDirectories(dirPath);
    }
    Path filePath = dirPath.resolve(fileName);
    Files.write(filePath, file.getBytes());
    return "/images/" + fileName; // 返回前端可直接访问的URL路径
}

最后再强调一句：生产环境永远不要依赖servletContext.getRealPath()，这个方法在不同容器、不同部署方式（比如Jar包部署）下表现不一致，稳定性极差，一定要用外部持久化目录来存储上传的文件。

内容的提问来源于stack exchange，提问作者Bara' ayyash