1. 多图分享报错现场Intent 与 Uri 到底谁在捣乱Android 系统分享多图时弹出「多文件分享仅支持照片格式」这个提示看着像格式问题实际上十有八九是 Intent 的 action、MIME 类型和 Uri 权限三者没对齐。我先把结论放前面系统分享多图必须用Intent.ACTION_SEND_MULTIPLEMIME 类型要写成image/*每个 Uri 都要带上FLAG_GRANT_READ_URI_PERMISSION而且从 Android 7.0N开始file://形式的 Uri 会被FileUriExposedException直接拦掉必须换成content://。很多人第一次遇到这个报错会以为是微信或系统相册限制了图片格式于是反复换 jpg、png 去试结果还是失败。真正的原因往往藏在三个地方一是用了ACTION_SEND却塞了多个 Uri接收方只认第一个二是 MIME 写成了image/jpeg这种具体类型多图场景下部分接收方会判定不匹配三是 Uri 没有授权接收应用读不到文件系统就回退成「格式不支持」的模糊提示。这篇就按「定位原因 → 配置骨架 → 验证请求 → 排错」的顺序走一遍。如果你在排查过程中需要快速验证某个模型对 Android 代码片段的解释或者想让 AI 帮你逐行读 logcat可以用 TaoToken 的模型对话能力配合着看省得在搜索里翻半天。下面先讲清楚 TaoToken 在这个场景里能帮上什么忙再进入代码。2. TaoToken 前置用模型对话辅助定位 Android 分享问题TaoToken 是一个大模型 API 聚合平台你可以把它理解成一个统一的入口用同一套 API Key 去调用不同厂商的模型。对 Android 开发者来说它的价值不在于替代 Android Studio而在于当你被FileUriExposedException或者「多文件分享仅支持照片格式」卡住时可以把报错栈、Intent 构造代码、FileProvider 配置一起贴给模型让它帮你逐项核对。我试过把一段ACTION_SEND_MULTIPLE的代码和 logcat 一起丢进去模型能直接指出「你的setType写成了image/jpeg多图应该用image/*」这种细节。这比在 StackOverflow 上翻十几年前的帖子快得多尤其是 Android N 之后 Uri 权限规则变过老帖子的答案经常是过时的。要用起来很简单先去官网注册账号然后在控制台创建 API Key。整个过程不需要额外配置网络环境浏览器直接打开就行官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content控制台创建 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keys 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content拿到 Key 之后你可以用模型对话页面直接贴代码问问题也可以走 API 把它集成到自己的调试脚本里。如果你打算长期用 AI 辅助 Android 开发比如让它帮你写 FileProvider 配置、生成单元测试那 Coding Plan 会更划算适合高频编码场景模型对话https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content需要说明的是TaoToken 在这里的角色是「帮你更快定位问题」不是替代 Android 本身的调试工具。真正的修复还得靠你改 Intent 和 FileProvider 配置。下面进入可复制的代码骨架。3. 可复制配置ACTION_SEND_MULTIPLE FileProvider 授权骨架先给一个能直接用的多图分享方法。核心要点我标在注释里你照着改路径和 Context 就行。public static void shareMultipleImages(Context context, ListFile imageFiles) { if (imageFiles null || imageFiles.isEmpty()) { return; } ArrayListUri uris new ArrayList(); for (File file : imageFiles) { // Android N 之后必须用 content:// file:// 会抛 FileUriExposedException Uri uri FileProvider.getUriForFile( context, context.getPackageName() .fileprovider, // 与 manifest 中 authorities 一致 file ); uris.add(uri); } Intent intent new Intent(); // 多图必须用 SEND_MULTIPLE用 SEND 只会传第一张 intent.setAction(Intent.ACTION_SEND_MULTIPLE); // 多图场景 MIME 用 image/* 不要写 image/jpeg 这种具体类型 intent.setType(image/*); intent.putParcelableArrayListExtra(Intent.EXTRA_STREAM, uris); // 给接收方读权限缺这行部分应用会读不到文件 intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); Intent chooser Intent.createChooser(intent, 分享图片); chooser.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); if (context instanceof Activity) { ((Activity) context).startActivity(chooser); } else { chooser.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); context.startActivity(chooser); } }对应的AndroidManifest.xml里 FileProvider 声明不能少provider android:nameandroidx.core.content.FileProvider android:authorities${applicationId}.fileprovider android:exportedfalse android:grantUriPermissionstrue meta-data android:nameandroid.support.FILE_PROVIDER_PATHS android:resourcexml/file_paths / /providerres/xml/file_paths.xml里要覆盖你实际存放图片的目录比如缓存目录和外部存储?xml version1.0 encodingutf-8? paths cache-path namecache_images pathimages/ / external-files-path nameexternal_images pathimages/ / files-path namefiles_images pathimages/ / /paths这里有个容易踩的坑FileProvider.getUriForFile的第二个参数必须和 manifest 里的android:authorities完全一致否则会抛IllegalArgumentException。很多人复制代码时只改了包名忘了改 authorities结果分享直接崩。另外如果你分享的不只是图片还有文本、压缩包那 MIME 类型要跟着变。文本用text/plain压缩包用application/zip但注意——微信这类应用对非图片的多文件分享支持有限报「只支持照片格式」有时是接收方本身的限制不是你的代码问题。这种情况可以用下面的验证方法确认。4. 验证请求逐项复现确认是格式限制还是 Uri 问题定位问题时不要一上来就改代码先做隔离验证。我一般按这个顺序走第一步只分享一张图用ACTION_SENDimage/*看能否成功。如果单图成功、多图失败那问题基本锁定在ACTION_SEND_MULTIPLE或 Uri 列表上。第二步多图但全部是 jpg用ACTION_SEND_MULTIPLEimage/*。如果成功说明代码骨架没问题之前失败可能是 MIME 写错或 Uri 没授权。第三步多图里混入一张 png 或 webp再试。如果这时报「只支持照片格式」那就要怀疑接收方对格式的支持范围而不是你的 Intent。第四步把setType从image/*改成*/*再试一次。如果*/*能弹出更多应用但分享仍失败说明是接收方过滤了类型如果*/*直接没有可选应用说明系统层面就没匹配到。验证时可以用 logcat 过滤FileUriExposedException和SecurityException这两个异常分别对应 Uri 方案错误和权限缺失。如果你把 logcat 贴给 TaoToken 的模型对话让它帮你判断是哪个环节出的问题通常几秒就能得到方向模型对话入口https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content还有一个实测有效的技巧在startActivity之前打印每个 Uri 的toString()确认它们是content://开头而不是file://。如果是file://那不用往下查了直接换 FileProvider。5. 本篇常见错排查从 FileUriExposedException 到 MIME 不匹配下面这张表是我整理的高频报错和对应原因你可以对照自己的 logcat 快速定位。报错/现象可能原因修复动作FileUriExposedException用了file://Uri改用FileProvider.getUriForFile提示「多文件分享仅支持照片格式」MIME 写成具体类型或接收方限制改image/*确认接收方支持范围分享后接收方读不到图缺FLAG_GRANT_READ_URI_PERMISSIONIntent 和 chooser 都加 flag只分享了第一张图用了ACTION_SEND改ACTION_SEND_MULTIPLEIllegalArgumentException: Failed to find configured rootfile_paths.xml没覆盖该目录补对应 path 节点部分应用不出现MIME 与接收方声明不匹配试*/*或调整类型其中「Failed to find configured root」这个错特别常见。比如你把图片存在getExternalFilesDir(images)但file_paths.xml里只写了cache-path那getUriForFile就会找不到匹配的根目录。解决办法是把external-files-path也加上路径写images/。另一个隐蔽的坑是 authorities 冲突。如果你同时引入了某个第三方库它也可能声明了 FileProvider两个 provider 的 authorities 如果一样安装时就会报冲突。这时候把你的 authorities 改成${applicationId}.fileprovider这种带包名的形式就能避开。如果你在排查时不确定某个报错该往哪个方向查可以把完整的异常栈贴到 API Keys 对应的调试脚本里或者直接用模型对话问。接入文档里有 API 调用的示例照着改就能把 logcat 自动发给模型分析API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后提醒一句Android 各版本对 Uri 权限的收紧是渐进的Android 10 之后分区存储又改了一轮。如果你的 targetSdk 比较高建议直接用MediaStore或FileProvider的标准路径别再用反射或绝对路径去绕。6. 把排查流程固化下来多图分享失败这件事说到底就是 Intent action、MIME 类型、Uri 权限三者的组合问题。我的建议是把这个排查流程写成一个 checklist下次遇到直接对照先确认 action 是SEND_MULTIPLE再确认 MIME 是image/*然后确认每个 Uri 都是content://且带了读权限最后用单图/多图/混合格式做隔离验证。如果你想让 AI 帮你把这段 checklist 变成一个可复用的调试工具比如自动解析 logcat 并给出修复建议可以走 Coding Plan 把模型能力接进你的开发流程Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content代码改完记得在真机上测模拟器的分享面板和真机不完全一样尤其是国产 ROM 对ACTION_SEND_MULTIPLE的处理差异挺大。测的时候优先用微信、相册、文件管理器这三个接收方基本能覆盖大部分场景。