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
相关产品推荐
相关产品推荐

