Flutter通过分享插件分享本地目录图片触发FileProvider权限拒绝报错求解

这个报错是Android 7.0+ 跨应用分享私有文件的权限机制未正确配置导致的：

• 你通过getApplicationDocumentsDirectory()获取的是应用沙箱私有目录，其他应用默认完全无权访问
• 跨应用分享私有文件必须通过FileProvider生成content://格式的URI，同时需要给接收方应用授予该URI的临时读取权限，你当前的配置缺少了必要的权限声明或授权标记，触发了系统的安全拦截。

1. 修正AndroidManifest.xml的FileProvider声明 #

打开android/app/src/main/AndroidManifest.xml，确保FileProvider节点满足以下配置：

• 必须添加android:grantUriPermissions="true"，这是允许临时给其他应用授权的开关，缺失就会触发当前的SecurityException
• 保持android:exported="false"（FileProvider本身不需要导出，靠临时授权即可跨应用访问）
• authorities字段必须和报错中的com.photogranth.watermark.contentprovider完全匹配，或者用${applicationId}.contentprovider动态适配包名
  示例配置：

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.contentprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

2. 配置FileProvider路径映射 #

在android/app/src/main/res/xml/目录下新建（或修改）file_paths.xml，将你要分享的应用文档目录映射进去，否则FileProvider无法定位到对应文件：
你使用的getApplicationDocumentsDirectory()在Android上对应路径为/data/data/<包名>/app_flutter/，配置如下：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 映射Flutter应用私有文档目录 -->
    <files-path name="app_doc" path="app_flutter/" />
    <!-- 如果需要分享其他目录，补充对应路径的映射即可 -->
</paths>

注意：如果不确定实际存储路径，可以先打印dir.path输出的实际值，再对应调整path字段的配置，确保映射路径和实际存储路径完全匹配，避免出现文件找不到的错误。

3. 检查分享Intent的授权标记 #

如果你使用的是自定义封装的FlutterShareFile插件，需要确认底层Android端的分享Intent添加了FLAG_GRANT_READ_URI_PERMISSION标记：
这个标记会给接收分享的应用临时授予该content:// URI的读取权限，是跨应用分享私有文件的必要配置。如果使用社区成熟的分享插件，该标记已经自动内置，无需手动处理。

4. 优化现有业务代码 #

你当前代码中声明的testFile变量为冗余代码，可以删除，同时建议增加文件存在性判断，避免分享空文件：

FlatButton(
  onPressed: () async {
    Directory dir = await getApplicationDocumentsDirectory();
    File imageFile = File("${dir.path}/image.png");
    // 先判断文件是否存在再发起分享
    if (await imageFile.exists()) {
      FlutterShareFile.shareImage(dir.path, "image.png", ShareFileType.image);
    }
  },
)

内容的提问来源于stack exchange，提问作者Raees Khatib