You need to enable JavaScript to run this app. Flutter WebView在Android应用Release模式下加载本地HTML白屏求助
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.11 12:54:03