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

已安装webview_flutter,Flutter Dart中仍无法使用WebView组件?

解决Flutter中WebView组件「未找到」的问题

以下是针对你遇到的问题的排查和修复方案:

1. 适配webview_flutter版本API

从webview_flutter 4.0.0版本开始,WebView组件的初始化逻辑发生了变更,不再支持直接通过initialUrl参数配置加载地址,需要通过WebViewController完成配置。

如果你的pubspec.yaml中依赖的是4.x及以上版本,修改代码如下:

import 'dart:io';
import 'package:flutter/material.dart';
import 'package:webview_flutter/webview_flutter.dart';

class WebViewExample extends StatefulWidget {
  @override
  _WebViewExampleState createState() => _WebViewExampleState();
}

class _WebViewExampleState extends State<WebViewExample> {
  late final WebViewController _controller;

  @override
  void initState() {
    super.initState();
    // 适配Android平台WebView实现
    if (Platform.isAndroid) {
      WebView.platform = SurfaceAndroidWebView();
    }
    // 初始化控制器并设置加载地址
    _controller = WebViewController()
      ..loadRequest(Uri.parse('https://flutter.dev'));
  }
 
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('WebView Example'),
      ),
      body: WebViewWidget(controller: _controller),
    );
  }
}

如果希望沿用旧版API(3.x及以下),可在pubspec.yaml中指定版本:

dependencies:
  webview_flutter: ^3.0.4

执行flutter pub get后即可使用你原有的代码结构。

2. 检查平台配置完整性

Android端配置

  • 打开android/app/src/main/AndroidManifest.xml,确保添加互联网权限:
<uses-permission android:name="android.permission.INTERNET" />
  • 确认minSdkVersion符合版本要求:webview_flutter 4.x要求至少20,3.x要求至少19,在android/app/build.gradle中修改:
defaultConfig {
    minSdkVersion 20 // 4.x版本填20,3.x版本填19
}

iOS端配置

  • 打开ios/Runner/Info.plist,添加网络请求权限配置(加载HTTPS地址可跳过,兼容HTTP场景建议添加):
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>
  • 确认iOS部署目标版本:webview_flutter 4.x要求至少12.0,3.x要求至少11.0,可在Xcode中修改Runner的Deployment Target。

3. 清理缓存并重启项目

  • 执行flutter clean清理项目缓存
  • 关闭当前Flutter运行进程,重新执行flutter run

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.07 12:50:19