使用flutter_file_view读取文件时遇引擎重试过多错误求助

开发者阿泽

2026-7-26

解决flutter_file_view TBS下载失败（错误码127）问题

从日志看，核心问题是腾讯TBS内核下载失败（错误码127），导致文件引擎初始化重试多次后崩溃。以下是针对性解决办法：

确认网络权限配置
检查Android项目的AndroidManifest.xml，确保添加了必要的网络权限：
```
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
```
TBS内核需要联网下载，缺少权限会直接导致下载失败。

强制允许非WiFi环境下载TBS内核
在Android原生代码的Application类onCreate方法中添加配置，允许TBS在移动网络下下载内核：

@Override
public void onCreate() {
    super.onCreate();
    // 允许非WiFi下载TBS内核
    com.tencent.smtt.sdk.QDownloader.setDownloadWithoutWifi(true);
    // 主动触发内核下载
    com.tencent.smtt.sdk.TbsDownloader.startDownload(this);
}

清除TBS缓存并重新初始化
卸载当前应用，清除设备上的TBS相关缓存，再重新安装应用，让TBS重新尝试下载内核。部分设备缓存损坏会导致重复下载失败。
降级flutter_file_view版本
如果使用的是最新版本，可能存在TBS适配问题。尝试切换到稳定旧版本（比如v2.0.0系列），参考pub仓库的版本历史选择用户反馈较好的版本。
替换本地渲染方案（备选）
如果TBS始终无法正常初始化，针对PDF可以改用pdf_render等本地渲染库；tex格式则可以考虑先转换为PDF再渲染，避开TBS依赖。