Flutter中WebView依赖异常：WebView方法未定义报错求助

云原生阿岚

2026-7-19

问题排查与解决

核心原因

你遇到的问题是因为webview_flutter 4.0.0及以上版本对API做了重大调整：原WebView组件被重命名为WebViewWidget，javascriptMode参数也从组件构造函数移到了WebViewController的配置中，旧写法不再兼容新版本依赖。

具体修复步骤

1. 确认依赖版本

检查pubspec.yaml中webview_flutter的版本，如果是4.x+，按以下方式修改代码；如果要保留旧写法，可以降级到3.x版本（不推荐，建议适配新版本）。

2. 修改代码适配新版本

更新State类中的代码，先创建WebViewController并配置参数，再使用WebViewWidget替代原WebView：

import 'package:webview_flutter/webview_flutter.dart';
...

class _UnamRadioHomePageState extends State<UnamRadioHomePage> {
  // 新增WebViewController配置
  final WebViewController _webViewController = WebViewController()
    ..setJavaScriptMode(JavaScriptMode.unrestricted)
    ..loadRequest(Uri.parse('https://iono.fm/s/194'));

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Unam Radio'),
      ),
      body: Column(
        children: [
          Expanded(
            // 替换WebView为WebViewWidget，并传入控制器
            child: WebViewWidget(controller: _webViewController),
          ),
          Expanded(
            child: Container(
              padding: const EdgeInsets.all(16),
              child: _getPageForItem(_selectedItem),
            ),
          ),
        ],
      ),
      drawer: UnamRadioDrawer(
        selectedItem: _selectedItem,
        onItemSelected: (item) {
          setState(() {
            _selectedItem = item;
          });
          Navigator.pop(context);
        },
      ),
    );
  }
}