Flutter WebView在Android应用Release模式下加载本地HTML白屏求助
以下是导致该问题的常见原因及对应修复方案,按出现概率从高到低排序:
1. Android R8混淆裁剪问题
Release版本默认开启R8混淆压缩,未配置webview_flutter相关保留规则时,WebView插件的核心类会被误裁剪,导致功能异常。Debug模式默认关闭混淆,因此不受影响。
修复步骤:
在项目的android/app/proguard-rules.pro文件中添加如下规则:
-keep class io.flutter.plugins.webviewflutter.** { *; }
如果你的HTML存在和Flutter侧交互的JS桥接自定义类,也需要给对应类添加keep规则,避免被混淆。
2. 缺少INTERNET权限声明
Debug模式下Flutter会默认注入INTERNET权限方便调试,但Release构建不会自动添加该权限。即使你加载的是本地生成的Data URI,部分Android系统版本仍会因为缺少网络权限拦截WebView的加载行为。
修复步骤:
在android/app/src/main/AndroidManifest.xml的manifest标签下添加权限声明:
<uses-permission android:name="android.permission.INTERNET" />
3. 编码动态获取异常
Release版本的代码优化逻辑可能裁剪未显式引用的编码实现,你代码中的Encoding.getByName('utf-8')在部分场景下会返回null,导致生成的URI格式异常,Debug模式无优化逻辑因此可以正常获取编码。
修复步骤:
直接使用dart:convert库的utf8常量替代动态获取的写法,修改loadPage方法:
import 'dart:convert' show utf8; void loadPage()async{ String html = await rootBundle.loadString('assets/html/invoice.html'); _webViewController?.loadUrl(Uri.dataFromString(html , mimeType: 'text/html', encoding: utf8) .toString()); }
4. 本地资源路径失效
如果你的invoice.html内部引用了CSS、JS、图片等其他本地Assets资源,使用Data URI的方式加载会导致HTML内的相对路径失效,Debug模式可能因为缓存、资源加载逻辑宽松可以正常访问,Release版严格校验路径就会加载失败。
修复步骤:
改用loadHtmlString方法加载HTML,同时配置基础URL指向Assets目录:
void loadPage()async{ String html = await rootBundle.loadString('assets/html/invoice.html'); _webViewController?.loadHtmlString( html, baseUrl: 'file:///android_asset/flutter_assets/', ); }
HTML内部的资源路径直接写相对于flutter_assets目录的路径即可,比如引用assets/html/style.css直接写./style.css即可。
内容的提问来源于stack exchange,提问作者ololo

