Flutter Web构建部署时遇TargetPlatform.macOS不支持地图插件错误

问题原因 #

在Mac设备上构建Flutter Web应用时，Flutter默认会将TargetPlatform设置为macOS，但google_maps_flutter_web插件仅适配Web平台，导致部署后触发不支持的平台错误。

解决方法 #

方法1：修改构建命令，强制指定Web平台 #

在构建Web版本时，添加--dart-define=FLUTTER_TARGET_PLATFORM=web参数，覆盖默认的平台设置：

flutter build web \
        --dart-define=BASE_URL="$base-url" \
        --web-renderer=html \
        --dart-define=FLUTTER_TARGET_PLATFORM=web

方法2：在代码中强制指定地图插件使用Web实现 #

如果构建命令修改无效，可以在应用初始化时手动指定地图插件的Web实现：

import 'package:flutter/foundation.dart';
import 'package:google_maps_flutter_web/google_maps_flutter_web.dart';
import 'package:google_maps_flutter/google_maps_flutter.dart';

void main() {
  if (kIsWeb) {
    GoogleMapPlatform.instance = GoogleMapWeb();
  }
  runApp(MyApp());
}

或者通过覆盖默认平台占位，让插件自动适配Web：

import 'package:flutter/foundation.dart';

void main() {
  if (kIsWeb) {
    debugDefaultTargetPlatformOverride = TargetPlatform.fuchsia;
  }
  runApp(MyApp());
}

验证方式 #

构建完成后重新部署到服务器，检查地图区域是否正常加载，确认错误提示消失。

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