You need to enable JavaScript to run this app. Windows 10下react-native-maps示例无法在Web浏览器正常运行
优惠活动
大模型
产品
解决方案
定价
更多

Windows 10下react-native-maps示例无法在Web浏览器正常运行

问题根因

你执行npm start启动的只是React Native默认的Metro Bundler打包服务,这个服务原生是给Android、iOS移动端做代码打包下发用的,8081端口返回的“React Native packager is running”提示页是Metro的默认状态展示页,根本不是项目的web端运行界面,哪怕手动刷新也不会加载业务内容。
你用的这个地图示例项目本身是纯面向移动端开发的React Native工程,完全没有预置web端的适配逻辑,单靠启动Metro服务是不可能在浏览器里跑通项目的。

分步解决操作

1. 补全web端运行的必需适配依赖

原项目没引入把RN组件转成web DOM的适配层,需要在项目根目录依次执行安装命令:

  • 安装核心web转译依赖:yarn add react-native-web react-dom @expo/metro-runtime
  • 全局安装web端启动工具:yarn global add expo-cli
    提示:你之前删掉了原项目自带的yarn.lock,后续所有依赖安装优先用yarn执行,别混用npm,不然容易出现版本缓存冲突

2. 修正之前的错误依赖安装操作

你之前手动yarn add装的三个地图相关库最新版,大多已经移除了对老版本RN的web适配能力,加上之前跑的npm audit fix会强制把所有依赖拉高到最高兼容版本,很容易打破原项目的版本兼容关系:

  • 先把三个地图相关依赖降到支持web运行的稳定版本,避免出现组件加载报错:
    yarn add react-native-maps@1.7.1 react-native-maps-directions@1.9.0 react-native-google-places-autocomplete@2.5.0
  • 清理之前npm生成的缓存和旧依赖目录,重新全量安装:
    在Windows PowerShell中执行:
    Remove-Item -Recurse -Force node_modules, package-lock.json
    命令跑完后执行yarn install拉取匹配全量版本的依赖。

3. 配置Google密钥的web端调用权限

你之前按项目要求配置的Google API密钥,默认通常绑定的是移动端应用签名校验规则,直接给web端调用会被Google接口拦截,出现鉴权失败:

  • 到Google开发者后台,为你启用的三个地图类API(地图展示、路径规划、地点搜索)开启web调用权限,把密钥的应用限制调整为允许localhost来源的请求,不然web端加载时会出现地图空白、接口无响应的问题。

4. 启动web端服务

  • 打开项目根目录下的package.json,在scripts配置块里新增启动命令:
    "web": "expo start --web"
  • 在项目根目录执行yarn web,等Metro完成web端代码转译打包后,会自动拉起默认浏览器打开项目运行页面,不需要手动去访问8081端口。
常见避坑提示
  • 启动后如果遇到端口被之前残留的Metro进程占用,可以在启动命令后追加自定义端口参数,比如expo start --web --port 8082,绕开端口冲突
  • 别把8081端口的Metro默认提示页当web入口,Metro的web模式会自动做组件映射,默认根路径是不会返回业务页面的
  • 启动过程中如果弹出依赖缺失的提示,按提示手动安装对应依赖就行,不要随意跑npm audit fix,很容易把项目依赖搞乱

内容的提问来源于stack exchange,提问作者JDS

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.10 11:54:10