Flutter中正确打开PDF等文件的方法及相关报错解决方案

开发者阿泽

2026-8-29

Flutter 打开PDF等本地文件问题解决方案

先解决构建阶段的阻塞报错

该报错是Android端单dex文件方法数触达65536上限导致，和文件打开类插件无直接关联，按以下步骤修复即可：

打开Android模块下的app/build.gradle文件，在defaultConfig配置块中添加multiDexEnabled true
在同文件的dependencies块中添加multidex依赖：implementation 'androidx.multidex:multidex:2.0.1'
无自定义Application类的场景，直接在AndroidManifest.xml的<application>标签中添加属性android:name="androidx.multidex.MultiDexApplication"；如果已有自定义Application类，将继承的父类从FlutterApplication改为MultiDexApplication
配置完成后执行flutter clean清除构建缓存，重新编译即可解决该报错。

注：当前需要加--no-sound-null-safety参数才能启动，说明项目中存在未适配空安全的依赖，建议逐步将相关依赖升级到支持空安全的版本，后续Flutter稳定版会逐步移除对非空安全模式的兼容支持。

之前尝试的两款插件都存在长期维护问题，不建议继续花时间排错：

以下方案均已适配Android V2 embedding、支持空安全，维护状态活跃，不需要复杂的原生配置：

使用社区维护的open_filex插件，该插件是原open_file的活跃fork版本，内部已经处理了Android 7+的文件Uri适配、高版本权限兼容等问题，不需要手动编写provider_paths.xml或调整Manifest的FileProvider配置：

import 'package:open_filex/open_filex.dart';

// 传入PDF文件的绝对路径，指定文件类型为pdf
await OpenFilex.open(
  localPdfFilePath,
  type: 'application/pdf',
);

Android端仅需按需配置对应版本的存储权限即可：targetSdkVersion 32及以下配置READ_EXTERNAL_STORAGE权限，targetSdkVersion 33及以上配置READ_MEDIA_DOCUMENTS等细分媒体读取权限，不需要额外做其他原生配置。

如果需要在应用内部直接展示PDF内容，不跳转系统第三方阅读器，使用flutter_pdfview插件即可：

在pubspec.yaml中添加依赖：flutter_pdfview: 最新稳定版
该插件同样完成了全版本Android、iOS适配，支持空安全，嵌入页面即可直接加载本地PDF文件，自带翻页、缩放、页码监听、跳转等基础能力，适合需要在应用内完成阅读闭环的场景。

所有原生配置、依赖调整完成后，必须先执行flutter clean清除旧构建缓存，再执行flutter pub get拉取依赖，否则大概率会因为缓存残留出现配置不生效的问题
Android 13及以上版本不要申请已废弃的READ_EXTERNAL_STORAGE权限，该权限在高版本系统上会被直接拒绝，导致无法读取本地文件
打开网络下载的PDF文件时，必须确认文件已经完整写入本地存储后再调用打开逻辑，未下载完成的损坏文件无法被正常加载。

内容的提问来源于stack exchange，提问作者Ariel Soriano Vassia