Flutter升级webview_flutter后构建报错：未设置WebViewPlatform实例

1. 移除不必要的依赖（可选但推荐） #

你的pubspec.yaml中单独引入了webview_flutter_platform_interface，但webview_flutter本身已经包含该依赖，无需单独声明。直接删除以下行：

webview_flutter_platform_interface: ^2.0.1

执行flutter pub get更新依赖。

2. 修复WebViewController的错误传递方式 #

你当前通过TimelinesScreen().getWebviewPlatform()手动实例化State对象获取控制器，这违反了Flutter的State管理规则——State必须由Flutter框架初始化，不能手动创建。

修改TimelinesScreen： #

class TimelinesScreen extends StatefulWidget {
  // 通过回调传递控制器给外部
  final ValueChanged<WebViewController>? onControllerCreated;

  const TimelinesScreen({Key? key, this.onControllerCreated}) : super(key: key);

  @override
  _TimelinesScreenState createState() => _TimelinesScreenState();
}

class _TimelinesScreenState extends State<TimelinesScreen> {
  late WebViewController controller;

  @override
  void initState() {
    super.initState();
    retriveLenguage();
    goBackToTimeline();
    _timelines = getTimelines();

    // 初始化控制器并配置导航逻辑
    controller = WebViewController()
      ..loadRequest(Uri.parse('https://flutter.dev'))
      ..setNavigationDelegate(NavigationDelegate(
        onNavigationRequest: (NavigationRequest request) {
          String url = request.url;
          var linkToShare = 'NoLink';

          if (url.startsWith("localtimeline://share")) {
            var uri = Uri.parse(url);
            linkToShare = uri.queryParameters['text'] ?? 'NoLink';
          }

          if (url.startsWith("whatsapp")) {
            var uri = Uri.parse(url);
            linkToShare = uri.queryParameters['text'] ?? 'NoLink';
          }

          if (url.startsWith("https://www.facebook.com") || url.startsWith("https://m.facebook.com")) {
            var uri = Uri.parse(url);
            linkToShare = uri.queryParameters['u'] ?? '';
            if (linkToShare.isEmpty && uri.queryParameters.containsKey('next')) {
              final nextUri = Uri.parse(uri.queryParameters['next']!);
              linkToShare = nextUri.queryParameters['u'] ?? 'NoLink';
            }
          }

          if (linkToShare != 'NoLink') {
            try {
              Share.text('Link from Local timeline', linkToShare, 'text/plain');
            } catch (e) {
              print('error: $e');
            }
          }
          return NavigationDecision.navigate;
        },
      ));

    // 将控制器传递给外部组件
    widget.onControllerCreated?.call(controller);
  }

  // 移除原有的getWebviewPlatform方法
  // ... 其余代码保持不变
}

修改WebViewScreen及跳转逻辑： #

// 在TimelinesScreen中跳转WebViewScreen的代码示例
Navigator.push(
  context,
  MaterialPageRoute(
    builder: (context) => WebViewScreen(controller: controller, url: "你的目标URL"),
  ),
);

// WebViewScreen代码
class WebViewScreen extends StatelessWidget {
  final WebViewController controller;
  final String? url;

  const WebViewScreen({Key? key, required this.controller, this.url}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    // 如果需要加载指定URL，更新控制器
    if (url != null) {
      controller.loadRequest(Uri.parse(url!));
    }
    return Scaffold(
      appBar: AppBar(),
      body: WebViewWidget(controller: controller),
    );
  }
}

3. 清理冗余代码 #

• 删除_TimelinesScreenState中的flutterWebviewPlugin变量，统一使用controller。
• 移除setUpListener方法中的错误类型转换（as StreamSubscription<String>），导航逻辑已整合到控制器初始化中。

4. 手动初始化平台实现（仅保留platform_interface依赖时需要） #

如果一定要保留webview_flutter_platform_interface，在main函数中添加平台初始化代码：

import 'package:webview_flutter_android/webview_flutter_android.dart';
import 'package:webview_flutter_wkwebview/webview_flutter_wkwebview.dart';
import 'package:webview_flutter_platform_interface/webview_flutter_platform_interface.dart';

void main() {
  // Android平台初始化
  if (WebViewPlatform.instance is AndroidWebViewPlatform) {
    AndroidWebViewPlatform.enableDebugging(true);
  }
  // iOS平台初始化
  if (WebViewPlatform.instance is WKWebViewPlatform) {
    // 可添加iOS专属配置
  }
  runApp(MyApp());
}

注：通常无需手动执行此步骤，webview_flutter会自动处理平台绑定。

• 手动实例化State对象是Flutter的禁忌，必须由框架管理State生命周期。
• 单独引入webview_flutter_platform_interface可能导致平台实现绑定异常。
• 冗余变量和错误类型转换导致逻辑混乱。

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