Android生成文件失败：java.lang.IllegalStateException:Failed to build unique file: /storage/emulated/0/...

1.问题说明

Android Q上，生成同一个名称的文件（类型+年月日），一开始好好的，突然有一天就报错了：

java.lang.IllegalStateException:Failed to build unique file: /storage/emulated/0/...

2.问题追踪

因为同一名称的文件会被系统在默认添加（1...）等数字用以标识，例如我有一个aa.txt文件，当我要再次生成aa.txt时，系统会帮我生成aa (1).txt文件，再生成则是aa (2).txt。

单从代码和日志去看是看不出问题出在哪里，只知道是程序已经执行到了context.contentResolver.insert。然后就抛异常了，异常是MediaProvider.ensureFileColumns抛出的，关键字是“Failed to build unique file”。

3.源码分析

我们前往MediaProvider的ensureFileColumns方法中的确看到了异常关键字：

也就是说这个异常是try里调用的两个方法造成的。再继续查看两个方法的源码，我们可以发现是FileUtils.buildUniqueFile调用FileUtils.buildUniqueFileWithExtension，对，就是这里，我们看到了罪魁祸首：

当括号中的名称数量大于32（含32，也就是说同一文件名的数量超过33个时）后就抛异常。

4.实践

我们去生成文件的路劲看看，可以发现真的是已经生成了32个相同名称的文件，当把它们删除后，程序又正常了。所以这里建议命名时加上分秒（以实际情况来定，只要不会出现同一文件名个数不超过32就好）。