记一个 Andorid 生成文件失败的bug
Android生成文件失败：java.lang.IllegalStateException:Failed to build unique file: /storage/emulated/0/...
1.问题来源
App 调用相机拍照，中间有一些处理过程，然后将这张照片插入系统图片数据库中。
MediaStore.Images.Media.insertImage(getContentResolver(), photoPath, null, null);
很长一段时间，这段代码都运行的好好的，可是突然有一天，测试妹妹报告一个bug，拍照之后，保存图片失败了，并且在 Gallery 中也看不到这张图片。
幸运地是，专业的测试妹妹，抓到了Log，很快找到了错误地方：
E DatabaseUtils: Writing exception to parcel
E DatabaseUtils: java.lang.IllegalStateException: Failed to build unique file: /storage/emulated/0/Pictures/Image.jpg bucket_display_name=Pictures volume_name=external_primary date_modified=null date_expires=null _display_name=Image.jpg mime_type=image/jpeg _data=/storage/emulated/0/Pictures/Image.jpg _size=null is_trashed=0 is_pending=0 bucket_id=-1617409521 relative_path=Pictures/
E DatabaseUtils: at com.android.providers.media.MediaProvider.ensureFileColumns(MediaProvider.java:2624)
E DatabaseUtils: at com.android.providers.media.MediaProvider.ensureUniqueFileColumns(MediaProvider.java:2368)
E DatabaseUtils: at com.android.providers.media.MediaProvider.updateInternal(MediaProvider.java:5265)
E DatabaseUtils: at com.android.providers.media.MediaProvider.update(MediaProvider.java:4953)
E DatabaseUtils: at android.content.ContentProvider$Transport.update(ContentProvider.java:457)
E DatabaseUtils: at android.content.ContentProviderNative.onTransact(ContentProviderNative.java:230)
E DatabaseUtils: at android.os.Binder.execTransactInternal(Binder.java:1159)
E DatabaseUtils: at android.os.Binder.execTransact(Binder.java:1123)
W MediaStore: Failed to insert image
W MediaStore: java.lang.IllegalStateException: Failed to build unique file: /storage/emulated/0/Pictures/Image.jpg bucket_display_name=Pictures volume_name=external_primary date_modified=null date_expires=null _display_name=Image.jpg mime_type=image/jpeg _data=/storage/emulated/0/Pictures/Image.jpg _size=null is_trashed=0 is_pending=0 bucket_id=-1617409521 relative_path=Pictures/
W MediaStore: at android.os.Parcel.createExceptionOrNull(Parcel.java:2381)
W MediaStore: at android.os.Parcel.createException(Parcel.java:2357)
W MediaStore: at android.os.Parcel.readException(Parcel.java:2340)
W MediaStore: at android.database.DatabaseUtils.readExceptionFromParcel(DatabaseUtils.java:190)
W MediaStore: at android.database.DatabaseUtils.readExceptionFromParcel(DatabaseUtils.java:142)
W MediaStore: at android.content.ContentProviderProxy.update(ContentProviderNative.java:649)
W MediaStore: at android.content.ContentResolver.update(ContentResolver.java:2356)
W MediaStore: at android.content.ContentResolver.update(ContentResolver.java:2318)
W MediaStore: at android.provider.MediaStore$Images$Media.insertImage(MediaStore.java:2097)
W MediaStore: at android.provider.MediaStore$Images$Media.insertImage(MediaStore.java:2059)
2.问题分析
显然这个异常并不是我们 App 中定义的，从日志可以看到程序执行到 MediaStore.Images.Media.insertImage() 方法出现异常了，异常是 MediaProvider.ensureFileColumns 抛出的，关键字是 Failed to build unique file 。
那只能查找源码了。在源码中搜 MediaProvider 的 ensureFileColumns 方法中,的确看到抛出了上述异常。
可以看到，这个一样应该是 FileUtils.buildUniqueFile() 或者 FileUtils.buidlNonUniqueFile() 方法抛出的。查看源码，我们发现是在 FileUtils.buildUniqueFile() 调用 FileUtils.buildUniqueFileWithExtension() 方法，抛出了异常。
看下这个方法大致就可以明白，同一名称的文件会被系统在默认添加（1...）等数字用以标识，例如我有一个aa.txt文件，当我要再次生成aa.txt时，系统会帮我生成aa (1).txt文件，再生成则是aa (2).txt。当括号中的名称数量大于32（含32，也就是说同一文件名的数量超过33个时）后就抛异常。
至此，破案了。
我们在调用
MediaStore.Images.Media.insertImage(getContentResolver(), photoPath, null, null);
方法时，第三个参数，插入数据库的文件的名称，传的 null, 系统会默认生成一个文件名，Image.jpg, 再次插入的则为 Image(1).jpg...
3.修改方案
修改方案明了了，只需要再插入系统数据库时，指定文件名。并且要尽量保持唯一。看来，系统接口设计很严谨，接口中每一个参数都是有意义的，比如该第四个参数，description，文件的描述，最好也要赋值。