You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter Web使用google_maps_flutter报MapTypeId相关TypeError

Flutter Web中google_maps_flutter组件显示红色且报TypeError: Cannot read properties of undefined (reading 'MapTypeId')的原因
  • Google Maps JavaScript SDK未正确加载
    该错误核心原因是网页中未引入或未正确引入Google Maps JavaScript SDK,导致全局google.maps对象不存在,无法读取MapTypeId属性。需确保在web/index.html文件中添加了正确的SDK脚本标签,且包含有效的API密钥。

  • API密钥配置异常
    若API密钥无效、未启用Maps JavaScript API,或设置了错误的域名访问限制,会导致SDK加载失败,google.maps对象无法初始化。需检查Google Cloud控制台中API密钥的状态,确认Maps JavaScript API已启用,且域名白名单包含当前测试/生产环境的域名。

  • 依赖版本不兼容
    google_maps_flutter包与Flutter SDK版本、或其web适配插件版本不匹配,可能引发底层JS交互逻辑错误。可尝试升级或降级google_maps_flutter至稳定版本,确保与当前Flutter版本兼容。

  • 组件初始化时机过早
    若在Google Maps JS SDK尚未加载完成时就初始化Flutter的GoogleMaps组件,此时google.maps对象还未就绪,会触发读取MapTypeId失败的报错。可通过监听window.google对象是否存在,控制组件在SDK加载完成后再渲染。

内容的提问来源于stack exchange,提问作者Code on the Rocks

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.15 11:05:53