前言 最近用SpringBoot写文件上传功能，使用参数绑定之后确实是非常的方便了。但是，项目部署就出现了问题，搞得我一脸懵逼。后来，才发现是因为我使用了相对路径导致的，这个绝对是一个坑人的地方，不过也说明需要学习的东西还有很多！

案例再现

@PostMapping("/uploadFile")
public String uploadImg(@RequestParam("file") MultipartFile file, @RequestParam("equipmentId") String equipmentId) {String baseDir = "./imgFile";  // 这里不能直接使用相对路径if (!file.isEmpty()) {String name = file.getOriginalFilename();String prefix = name.lastIndexOf(".") != -1 ? name.substring(name.lastIndexOf(".")) : ".jpg";String path = UUID.randomUUID().toString().replace("-", "") + prefix;try {// 这里代码都是没有问题的File filePath = new File(baseDir, path);// 第一次执行代码时，路径是不存在的logger.info("文件保存路径：{}，是否存在：{}", filePath.getParentFile().exists(), filePath.getParent());if (!filePath.getParentFile().exists()) {   // 如果存放路径的父目录不存在，就创建它。filePath.getParentFile().mkdirs();}// 如果路径不存在，上面的代码会创建路径，此时路径即已经创建好了logger.info("文件保存路径：{}，是否存在：{}", filePath.getParentFile().exists(), filePath.getParent());// 此处使用相对路径，似乎是一个坑！// 相对路径：filePath// 绝对路径：filePath.getAbsoluteFile()logger.info("文件将要保存的路径：{}", filePath.getPath());file.transferTo(filePath);logger.info("文件成功保存的路径：{}", filePath.getAbsolutePath());return "上传成功";} catch (Exception e) {logger.error(e.getMessage());}}return "上传失败";
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22
• 23
• 24
• 25
• 26
• 27
• 28
• 29
• 30

我在日志中打印了路径的位置，显示是没有问题，当时一旦执行到file.transferTo(filePath);就会产生一个FileNotFoundException，但是我前面的代码是执行了，并且创建了一个文件夹的。

Postman测试截图

日志输出

2020-11-27 10:15:06.519  INFO 5200 --- [nio-8080-exec-1] r.controller.LearnController             : 文件保存路径：false，是否存在：.\imgFile
2020-11-27 10:15:06.521  INFO 5200 --- [nio-8080-exec-1] r.controller.LearnController             : 文件保存路径：true，是否存在：.\imgFile
2020-11-27 10:15:06.521  INFO 5200 --- [nio-8080-exec-1] r.controller.LearnController             : 文件将要保存的路径：.\imgFile\684918a520684801b658c85a02bf9ba5.jpg
2020-11-27 10:15:06.522 ERROR 5200 --- [nio-8080-exec-1] r.controller.LearnController             : java.io.FileNotFoundException: C:\Users\Alfred\AppData\Local\Temp
\tomcat.8080.2388870592947355119\work\Tomcat\localhost\ROOT\.\imgFile\684918a520684801b658c85a02bf9ba5.jpg (系统找不到指定的路径。)

• 1
• 2
• 3
• 4
• 5
• 6

注意： 这里虽然没有什么头绪，当时观察日志可以发现，程序试图将文件保存到一个很奇怪的目录下，当是这个目录和前面那个filePath已经没有关系了，这里是一个疑点！

执行之后代码所在目录下面已经创建了一个imgFile目录

imgFile文件夹中是空的，因为执行transferTo时抛出了异常

修改此处传如的参数，改为文件的绝对路径

file.transferTo(filePath.getAbsoluteFile());

• 1

Postman测试截图

上传成功！

执行之后代码所在目录下面已经创建了一个imgFile目录

imgFile文件夹中已经有了上传的图片

原因分析

上面失败与成功只是因为路径所代表的是相对路径和绝对路径的区别。这就说明是MultiparFile的transferTo方法有问题了。让我们加一个断点，调试走一波！debug！

补充一个debug的小知识：

debug tips：
step into: 单步执行，遇到子函数就进入并且继续单步执行（F5）
step over: 在单步执行时，在函数内遇到子函数时不会进入子函数内单步执行，而是将子函数整个执行完再停止，也就是把子函数整个作为一步（F6）
step return: 在单步执行到子函数内时，用step return就可以执行完子函数余下部分，并返回上一层。
setp out: 效果同 step return。

我这里只给file.transferTo(filePath.getAbsoluteFile());这行代码加了断点，这里我给出调试中最重要的两个步骤：

调试中代码的执行流程是：
但代码进入 transferTo 后，然后执行 this.part.write(dest.getpath）方法，进入 write 方法内部，到这里就可以得到我们的答案了！

@Override
public void transferTo(File dest) throws IOException, IllegalStateException {this.part.write(dest.getPath());if (dest.isAbsolute() && !dest.exists()) {// Servlet 3.0 Part.write is not guaranteed to support absolute file paths:// may translate the given path to a relative location within a temp dir// (e.g. on Jetty whereas Tomcat and Undertow detect absolute paths).// At least we offloaded the file from memory storage; it'll get deleted// from the temp dir eventually in any case. And for our user's purposes,// we can manually copy it to the requested location as a fallback.FileCopyUtils.copy(this.part.getInputStream(), Files.newOutputStream(dest.toPath()));}
}