Flutter加载model-viewer页面报错：TargetPlatform.windows无默认WebView实现

• 你使用的model_viewer v0.8.1版本底层依赖webview_flutter官方库实现3D模型渲染，webview_flutter稳定版默认仅支持Android、iOS、macOS三个平台，你当前在Windows平台运行调试，没有对应的默认WebView实现，所以抛出不支持的错误。
• 报错栈中出现Flutter Web SDK相关信息，如果你是在Web端调试也会触发该问题：webview_flutter本身不支持Flutter Web平台，无法在Web环境下实例化WebView组件。

场景1：需要在Windows桌面端调试运行 #

• 第一步：在pubspec.yaml中新增Windows平台WebView支持依赖：

dependencies:
  webview_flutter_windows: ^latest_version

• 第二步：在应用启动入口main.dart的main()函数中手动注册Windows平台的WebView实现：

import 'dart:io';
import 'package:webview_flutter_windows/webview_flutter_windows.dart';

void main() {
  if (Platform.isWindows) {
    WebViewPlatform.instance = WindowsWebViewPlatform();
  }
  runApp(const MyApp());
}

注意：需要将Flutter桌面开发环境升级到2.10及以上稳定版本，才支持Windows平台WebView。

场景2：需要在Flutter Web端运行 #

放弃使用model_viewer这个基于WebView的包，改用Web原生支持方案：直接在Web项目的index.html中引入Google官方model-viewer前端组件，通过HtmlElementView嵌入Flutter页面调用，无需依赖WebView。

场景3：仅需移动端（Android/iOS）运行 #

切换到Android或iOS模拟器/真机调试即可，无需额外修改代码，webview_flutter本身对这两个平台有默认实现支持。

兼容兜底方案 #

在页面加载前先判断当前运行平台，不支持的平台直接展示提示避免崩溃：

@override
Widget build(BuildContext context) {
  bool isSupported = Platform.isAndroid || Platform.isIOS || Platform.isMacOS;
  return Scaffold(
    appBar: AppBar(title: const Text("Model Viewer")),
    body: isSupported ? ModelViewer(
      src: 'assets/models/Astronaut.glb',
      alt: "A 3D model of an astronaut",
      ar: true,
      autoRotate: true,
      cameraControls: true,
    ) : Center(
      child: Text("当前平台暂不支持3D模型预览"),
    ),
    drawer: MyDrawer(title: title),
  );
}

内容的提问来源于stack exchange，提问作者kawaii-kitsune