You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter InAppWebView加载后白屏问题求助(含报错信息)

解决flutter_inappwebview Web端白屏/Flutlab报错问题

针对你遇到的问题,以下是具体解决步骤:

1. 补充Web平台初始化代码

flutter_inappwebview在Web端需要显式初始化桥接层,否则会触发nativeCommunication未定义的报错。修改main函数,添加Web端专属初始化逻辑:

import 'package:flutter/foundation.dart'; // 导入kIsWeb判断

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 仅在Web平台执行初始化
  if (kIsWeb) {
    await WebInAppWebViewController.initialize();
  }
  runApp(MyApp());
}

2. 移除Web端不支持的配置

transparentBackground属性目前在Web端未实现,会导致渲染异常(白屏/黑屏),直接从initialSettings中移除:

initialSettings: InAppWebViewSettings(
  javaScriptEnabled: true,
  useOnDownloadStart: true,
  // 删掉transparentBackground配置
),

3. 适配Flutlab环境

  • 检查pubspec.yaml中flutter_inappwebview的版本,建议使用稳定版(如^6.0.0),避免和Flutlab的Flutter SDK版本冲突;
  • 确保Flutlab项目已开启Web平台支持,可在项目设置中确认Web平台已启用。

4. 普通WebView报错排查(通用)

如果普通WebView也报错,说明Web平台基础配置缺失:

  • 执行flutter create --platforms web .为项目添加Web平台支持;
  • 检查web/index.html文件,确保flutter.js等核心脚本正确引入。

修改后的完整代码

import 'package:flutter/material.dart';
import 'package:flutter_inappwebview/flutter_inappwebview.dart';
import 'package:flutter/foundation.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  if (kIsWeb) {
    await WebInAppWebViewController.initialize();
  }
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        body: SafeArea(
          child: Stack(
            children: [
              InAppWebView(
                initialUrlRequest: URLRequest(url: WebUri("https://abdoohmaad.wordpress.com/")),
                initialSettings: InAppWebViewSettings(
                  javaScriptEnabled: true,
                  useOnDownloadStart: true,
                ),
                onLoadStop: (controller, url) {},
              ),
              const Center(child: CircularProgressIndicator()),
            ],
          ),
        ),
      ),
    );
  }
}

内容的提问来源于stack exchange,提问作者gaming tech

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.19 09:21:11