Flutter WebView应用发布至Google Play后白屏问题求助

1. 网络权限缺失或明文流量限制 #

发布版APK不会自动授予网络权限，且Android 9及以上系统默认阻止明文HTTP流量，这会导致WebView无法连接Django站点。

• 解决方法：
  • 在android/app/src/main/AndroidManifest.xml中添加网络权限：

    <uses-permission android:name="android.permission.INTERNET" />
    

  • 若Django站点使用HTTP而非HTTPS，需在application标签内添加：

    android:usesCleartextTraffic="true"
    

2. WebView混合内容限制 #

发布版WebView默认拦截HTTPS页面加载HTTP资源的混合内容操作，若Django站点存在这类资源，会直接导致页面加载失败。

• 解决方法：
  • 优先将Django站点切换为HTTPS（推荐方案）；
  • 若暂时无法切换HTTPS，在Flutter的WebView配置中允许混合内容：

    WebView(
      initialUrl: "你的Django站点URL",
      javascriptMode: JavascriptMode.unrestricted,
      androidWebViewWidgetCreationParams: AndroidWebViewWidgetCreationParams(
        initialSettings: AndroidInitialSettings(
          mixedContentMode: AndroidMixedContentMode.alwaysAllow,
        ),
      ),
    )
    

3. ProGuard/R8混淆破坏WebView功能 #

发布版构建时启用的代码混淆可能误删WebView相关类或方法，导致WebView无法正常初始化和加载内容。

• 解决方法：
  • 在android/app/proguard-rules.pro中添加混淆排除规则：

    -keep class android.webkit.** { *; }
    -keep class io.flutter.plugins.webviewflutter.** { *; }
    

4. 域名白名单未配置 #

部分WebView插件或Android系统会限制加载的域名范围，若未将Django站点域名加入白名单，请求会被拦截。

• 解决方法：
  • 在WebView的navigationDelegate中允许目标域名的跳转：

    navigationDelegate: (NavigationRequest request) {
      if (request.url.startsWith("你的Django站点域名前缀")) {
        return NavigationDecision.navigate;
      }
      return NavigationDecision.prevent;
    },
    

5. WebView缓存/本地存储禁用 #

Django应用可能依赖WebView的本地存储或缓存完成初始化，发布版默认可能禁用这些功能，导致页面加载异常。

• 解决方法：
  • 在WebView配置中启用相关功能：

    AndroidInitialSettings(
      domStorageEnabled: true,
      databaseEnabled: true,
      cacheMode: AndroidCacheMode.loadDefault,
    )
    

6. 缺少错误日志定位问题 #

本地调试有控制台日志辅助排查，但发布版无法直接查看错误信息，导致无法定位具体问题。

• 解决方法：
  • 添加WebView错误监听，捕获加载失败的具体信息：

    onWebResourceError: (WebResourceError error) {
      print("WebView加载错误: ${error.description}, 错误码: ${error.errorCode}");
      // 可将错误信息上报到日志服务，比如Firebase Crashlytics
    },
    

  • 集成Firebase Crashlytics等工具，收集发布版的崩溃和错误日志。

内容的提问来源于stack exchange，提问作者lordvoldemort