Flutter升级至3.22.0后使用share_plus分享Widget截图出现Android端FileProvider路径异常问题

AI 小北

2026-4-17

碰到这个问题真的挺闹心的——明明iOS 17.5端用着毫无问题，之前Android也好好的，升级Flutter 3.22.0后突然就报找不到FileProvider配置根目录的错误，我来帮你梳理下可能的原因和解决办法！

问题核心

这个报错的本质是Android的FileProvider配置没有覆盖到share_plus生成临时文件的路径，升级Flutter后可能插件的临时文件存储路径或者系统的权限校验逻辑变了，导致原本兼容的配置现在失效了。

解决方案

1. 修复FileProvider的路径配置（最关键）

打开你的android/app/src/main/AndroidManifest.xml，找到FileProvider的配置节点，确保它的android:authorities是你的App ID加上.fileprovider（比如com.your.app.id.fileprovider），然后检查它指向的file_paths.xml文件：

在android/app/src/main/res/xml/file_paths.xml（如果没有就新建一个）里，添加对应用缓存目录的配置：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 授权整个应用缓存目录给FileProvider -->
    <cache-path name="app_cache" path="."/>
    <!-- 也可以单独指定share_plus的子目录，更精准 -->
    <cache-path name="share_plus_cache" path="share_plus/"/>
</paths>

这里的path="."表示允许FileProvider访问整个缓存目录，这样share_plus生成的/data/data/app.id/cache/share_plus/drawing.png就会被包含在授权路径里了。

2. 直接用Uint8List分享，跳过本地文件存储

既然你已经有了Widget截图的Uint8List数据，不如试试绕开本地文件，直接用XFile.fromData来分享，这样能避免路径权限问题：

import 'package:share_plus/share_plus.dart';
import 'package:xfile/xfile.dart';

// 假设你的截图数据是capturedImage（Uint8List类型）
final shareFile = XFile.fromData(
  capturedImage,
  mimeType: 'image/png',
  name: 'drawing.png',
);
await Share.shareXFiles([shareFile], text: '分享我的截图');

另外记得把share_plus升级到最新稳定版（比如v7.x系列），新版本插件通常会适配最新的Flutter版本，修复这类兼容性问题。

3. 规范临时文件的存储路径

如果你还是需要先把文件存到本地，确保用官方推荐的方式获取临时目录：

import 'package:path_provider/path_provider.dart';
import 'dart:io';

final tempDir = await getTemporaryDirectory();
final savePath = '${tempDir.path}/share_plus/drawing.png';
final file = File(savePath);
await file.writeAsBytes(capturedImage);
// 再用这个路径生成XFile分享

用getTemporaryDirectory()获取的路径是系统认可的缓存目录，不会出现FileProvider找不到根的问题。

额外提醒

大概率是Flutter 3.22.0对Android的文件权限或路径处理做了微调，而旧版share_plus或者你的FileProvider配置没跟上，导致原本隐藏的问题暴露出来。先升级插件版本，再检查配置，应该就能解决啦！

备注：内容来源于stack exchange，提问作者Luca Nicoletti