java.io.File的renameTo方法移动文件失败的解决方案

今天线上发现一个问题，发现一个定时移动文件的业务没有正常执行，结合日志和代码发现，移动文件是使用File类的renameTo方法，但是方法返回的都是false，表示文件移动失败。

出现这个问题我第一反应是不是文件权限的问题，但是和运维研究后发现的确不是权限导致的。既然不是权限的问题，那就看看renameTo的实现吧，查看源码发现该方法最终是通过一个本地方法实现的，看不到咋写的。

网上查了一下renameTo这个方法，发现这个方法确实存在一些问题，就是在不同的文件系统中移动是不会成功的。因为测试环境并未出现这个问题，我就把生产环境和测试环境对比了下，发现测试环境下，文件本身的目录和要移动到的目录是在/home下，而生产环境中，文件本身目录是在/home下，要移动到的目录都是在/data下。于是用df命令查看了一下，发现 /home的文件系统是/dev/sda3,类型是xfs的，/data的文件系统是/dev/sdb1,类型是ext4。

既然是这样那就写个demo在自己的虚拟机上验证一下是不是这个原因导致的。

1.首先找两个文件系统不一样的目录，命令df -T

我们用/tmp 和 /run 作为测试目录。

2.测试代码

1. import java.io.File;
2. /**
3. * 文件移动方法测试
4. */
5. public class FileTest {
6. public static void main(String[] args) {
7. String filePath="/tmp/test.txt";
8. File file = new File(filePath);
9. boolean b = file.renameTo(new File("/run/test.txt"));
10. System.out.println(b);
11. }
12. }

3.编译运行

1. javac FileTest.java
2. java FileTest

运行结果输出false，文件也确实未移动成功

解决方法：

使用apache的commons-io包中的工具类的进行文件移动。

1.测试代码：

1. import org.apache.commons.io.FileUtils;
2. import java.io.File;
3. import java.io.IOException;
4. /**
5. * 文件移动方法测试
6. */
7. public class FileTest {
8. public static void main(String[] args) {
9. String filePath="/tmp/test.txt";
10. File file = new File(filePath);
11. boolean b = file.renameTo(new File("/run/test.txt"));
12. System.out.println(b);
13. //使用apache的FileUtils工具
14. try {
15. FileUtils.moveFile(file,new File("/run/test.txt"));
16. System.out.println("success");
17. } catch (IOException e) {
18. e.printStackTrace();
19. }
20. }
21. }

2.编译运行

1. javac -cp /root/jar/commons-io-2.4.jar FileTest.java
2. java -cp /root/jar/commons-io-2.4.jar: FileTest

运行结果成功移动文件

3.apache的FileUtils移动文件方法的主要实现如下：

1. //先使用renameTo方法进行移动
2. boolean rename = srcFile.renameTo(destFile);
3. if (!rename) {
4. //renameTo移动失败，就复制文件，然后删除原文件
5. copyFile( srcFile, destFile );
6. if (!srcFile.delete()) {
7. FileUtils.deleteQuietly(destFile);
8. throw new IOException("Failed to delete original file '" + srcFile +
9. "' after copy to '" + destFile + "'");
10. }
11. }

总结：

1、文件移动最好不要使用Java的renameTo方法，而是应该使用apache的commons-io包，当然也可以自己封装类似的方法。

2、renameTo方法移动失败是文件系统不同造成的，补充测试发现不同的文件系统，就算类型相同，移动也会失败。

以上为个人经验，希望能给大家一个参考，也希望大家多多支持我们。

原文链接：https://my.oschina.net/u/2424727/blog/1933126