解决Android文件共享异常：FileUriExposedException的实战指南
1. 为什么你的Android应用突然崩溃了？
那天我正在调试一个视频编辑功能，点击分享按钮时应用突然闪退，日志里赫然出现一行刺眼的红色错误：android.os.FileUriExposedException。相信不少Android开发者都遇到过这个经典异常，特别是在处理文件共享时。这个错误的本质是Android 7.0（API 24）引入的"严格模式文件URI暴露"安全机制导致的。
简单来说，当你尝试通过file://URI将应用私有文件共享给其他应用时，系统会直接抛出这个异常。这就像你家的门牌号突然被公开在社交媒体上，任何人都能找上门来——显然存在安全隐患。Android系统为了防止这种不安全的数据共享方式，强制要求使用更安全的FileProvider机制。
我查了下数据，在Stack Overflow上关于这个异常的提问超过1.2万条，在Crashlytics统计的崩溃排行榜上常年位居前20。最容易触发这个异常的场景包括：
- 调用系统相机拍照后保存图片
- 视频编辑后分享到社交媒体
- 通过Intent打开第三方应用查看文档
- 应用间文件共享功能
2. FileUriExposedException的底层原理
2.1 从报错堆栈看问题根源
先来看一个典型的错误堆栈：
android.os.FileUriExposedException: file:///storage/emulated/0/DCIM/Camera/VIDEO.mp4 exposed beyond app through Intent.getData() at android.os.StrictMode.onFileUriExposed(StrictMode.java:2141) at android.net.Uri.checkFileUriExposed(Uri.java:2391) at android.content.Intent.prepareToLeaveProcess(Intent.java:11165)关键点在于prepareToLeaveProcess方法，当Intent要启动其他应用的Activity时，系统会检查数据URI是否合规。如果发现是file://格式且目标应用与当前应用不在同一个Linux用户ID下，就会触发这个保护机制。
2.2 Android权限模型的演变
在Android 7.0之前，应用可以通过file://URI自由共享文件。但这样会带来严重的安全问题：
- 任何应用都可以读取这些文件
- 无法精确控制访问权限
- 文件路径可能包含敏感信息
FileProvider的引入解决了这些问题：
- 通过content://URI替代file://
- 支持临时权限授予
- 隐藏真实文件路径
- 支持路径访问限制
3. 四步解决FileUriExposedException
3.1 第一步：声明FileProvider
在AndroidManifest.xml中添加：
<provider android:name="androidx.core.content.FileProvider" android:authorities="${applicationId}.files" android:exported="false" android:grantUriPermissions="true"> <meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_paths" /> </provider>关键参数说明：
authorities：建议使用应用包名作为前缀exported：设为false确保只有你的应用能访问grantUriPermissions：允许临时授权
3.2 第二步：配置共享路径
创建res/xml/file_paths.xml：
<?xml version="1.0" encoding="utf-8"?> <paths> <external-path name="external_files" path="." /> <external-files-path name="external_files_path" path="." /> <cache-path name="cache_path" path="." /> </paths>路径类型说明：
external-path：对应Environment.getExternalStorageDirectory()external-files-path：getExternalFilesDir()cache-path：getCacheDir()
3.3 第三步：改造代码逻辑
修改前的危险代码：
Uri uri = Uri.fromFile(file); // 会产生file://URI intent.setDataAndType(uri, "video/*");安全改造后的代码：
Uri uri = FileProvider.getUriForFile( context, context.getPackageName() + ".files", // 与manifest中一致 file); intent.setDataAndType(uri, "video/*"); intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);3.4 第四步：处理接收方兼容性
有些老版本应用可能不支持content://URI，需要特殊处理：
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { uri = FileProvider.getUriForFile(...); } else { uri = Uri.fromFile(file); }4. 实际开发中的五个坑点
4.1 路径配置错误
最常见的错误是file_paths.xml中路径配置不匹配。比如：
<!-- 错误示例 --> <external-path path="Pictures" />当尝试访问/storage/emulated/0/DCIM/file时就会失败，因为路径不匹配。
正确做法是使用.表示根目录，或者完整路径：
<external-path path="DCIM/" />4.2 权限未正确授予
忘记添加FLAG_GRANT_READ_URI_PERMISSION会导致接收方无权限访问。更稳妥的做法是：
intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);4.3 多模块冲突
当应用有多个模块时，可能会出现FileProvider冲突。解决方法是在每个模块使用不同的authorities：
<!-- 主模块 --> android:authorities="${applicationId}.main_files" <!-- 功能模块 --> android:authorities="${applicationId}.feature_files"4.4 文件路径变化
有些手机厂商会修改存储路径，比如华为的"内部存储/外部存储"逻辑不同。建议使用Context获取路径：
File file = new File(context.getExternalFilesDir(null), "video.mp4");4.5 第三方应用兼容
测试发现微信7.0以下版本对content://URI支持不完善，需要特殊处理：
if (isWeChat() && !isWeChatVersionSupported()) { uri = getUriThroughPublicDirectory(file); }5. 高级应用场景
5.1 分享多个文件
通过Intent.createChooser分享多个文件时，需要为每个URI单独授权：
ArrayList<Uri> uris = new ArrayList<>(); Intent intent = new Intent(Intent.ACTION_SEND_MULTIPLE); for (File file : files) { Uri uri = FileProvider.getUriForFile(...); uris.add(uri); intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); } intent.putParcelableArrayListExtra(Intent.EXTRA_STREAM, uris);5.2 自定义FileProvider
当需要特殊处理时可以继承FileProvider：
public class CustomFileProvider extends FileProvider { @Override public boolean onCreate() { // 自定义初始化逻辑 return super.onCreate(); } }然后在manifest中使用自定义类：
android:name=".CustomFileProvider"5.3 动态路径配置
通过覆写getFileForUri实现动态路径：
@Override public File getFileForUri(Uri uri) { if (uri.getPath().contains("/special/")) { return handleSpecialCase(uri); } return super.getFileForUri(uri); }6. 测试与验证技巧
6.1 单元测试方案
使用AndroidX Test测试FileProvider：
@RunWith(AndroidJUnit4.class) public class FileProviderTest { @Test public void testFileUriConversion() { Context context = ApplicationProvider.getApplicationContext(); File file = new File(context.getFilesDir(), "test.txt"); Uri uri = FileProvider.getUriForFile( context, context.getPackageName() + ".files", file); assertThat(uri.getScheme()).isEqualTo("content"); } }6.2 真机调试技巧
在开发者选项中开启"严格模式"，可以提前发现URI暴露问题：
adb shell settings put global strict_mode_visible 16.3 常见错误码
监控这些关键日志：
FileUriExposedException：URI暴露SecurityException：权限不足IllegalArgumentException：路径配置错误
7. 性能优化建议
7.1 URI缓存机制
频繁获取URI会有性能开销，可以建立缓存：
private static LruCache<String, Uri> uriCache = new LruCache<>(100); public static Uri getCachedUri(Context context, File file) { String key = file.getAbsolutePath(); Uri uri = uriCache.get(key); if (uri == null) { uri = FileProvider.getUriForFile(...); uriCache.put(key, uri); } return uri; }7.2 批量授权优化
当需要授权给多个应用时，使用PackageManager批量检查：
List<ResolveInfo> apps = pm.queryIntentActivities(intent, 0); for (ResolveInfo app : apps) { context.grantUriPermission( app.activityInfo.packageName, uri, Intent.FLAG_GRANT_READ_URI_PERMISSION); }8. 替代方案对比
8.1 使用MediaStore
对于媒体文件，MediaStore是更现代的方案：
ContentValues values = new ContentValues(); values.put(MediaStore.Video.Media.DATA, file.getAbsolutePath()); Uri uri = context.getContentResolver().insert( MediaStore.Video.Media.EXTERNAL_CONTENT_URI, values);8.2 使用Storage Access Framework
通过Intent.ACTION_OPEN_DOCUMENT获取长期访问权限：
Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT); intent.addCategory(Intent.CATEGORY_OPENABLE); intent.setType("video/*"); startActivityForResult(intent, REQUEST_CODE);在开发视频编辑类应用时，我花了整整两天时间排查各种文件共享问题。最深刻的教训是：不要假设所有设备的行为都一致，华为、小米等厂商的定制ROM可能会带来意想不到的问题。现在我的调试清单上永远有一条：检查FileProvider配置是否完整。