Flutter Android应用中无法使用webview_flutter库求助

以下是针对该问题的排查和解决步骤：

• 彻底重新安装依赖

  1. 执行flutter clean清理项目编译缓存
  2. 运行flutter pub get重新拉取依赖
  3. 重启你的开发IDE（Android Studio/VS Code），IDE缓存经常会导致新依赖无法被识别

• 验证导入语句与组件用法
  webview_flutter 4.x版本的正确导入为：

  import 'package:webview_flutter/webview_flutter.dart';
  

  两种组件写法都需要正确初始化控制器：

  // 初始化控制器
  final WebViewController _controller = WebViewController()
    ..loadRequest(Uri.parse('https://example.com'));
  
  // 使用WebViewWidget
  WebViewWidget(controller: _controller)
  
  // 或者使用WebView组件
  WebView(controller: _controller)
  

  检查导入语句是否拼写错误，确保没有导入错误的包。

• 检查Android项目配置
  webview_flutter 4.x要求Android最低SDK版本为API 21（Android 5.0），打开android/app/build.gradle确认配置：

  defaultConfig {
      minSdkVersion 21 // 必须≥21
  }
  

  配置修改后，执行Android Studio的File → Sync Project with Gradle Files同步项目。

• 清理IDE缓存

  • VS Code：打开命令面板（Ctrl+Shift+P/Command+Shift+P），运行Flutter: Restart Analysis Server
  • Android Studio：点击File → Invalidate Caches...，勾选Invalidate and Restart

• 排查依赖冲突
  执行flutter pub deps查看项目依赖树，确认是否有其他第三方包与webview_flutter存在版本冲突，导致依赖未正确安装。

如果上述步骤都无效，可以尝试：

1. 删除项目根目录下的pubspec.lock文件，重新执行flutter pub get
2. 创建一个全新的Flutter测试项目，仅添加webview_flutter依赖，验证能否正常使用，以此排除项目本身的配置问题。

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