React Native iOS执行pod install时GoogleMaps安装失败（404错误）

问题描述 #

执行pod install时安装GoogleMaps 8.4.0失败，错误信息如下：

Installing GoogleMaps (8.4.0)
[!] Error installing GoogleMaps
[!] /usr/bin/curl -f -L -o /var/folders/_s/b2y1_v7j23j5666ynpqqczd00000gn/T/d20241019-13159-23rzjl/file.tgz https://dl.google.com/dl/cpdc/bad57bdf1f06c544/GoogleMaps-8.4.0.tar.gz --create-dirs --netrc-optional --retry 2 -A 'CocoaPods/1.15.2 cocoapods-downloader/2.1'
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
0 1449 0 0 0 0 0 0 --:--:-- 0:00:01 --:--:-- 0
curl: (56) The requested URL returned error: 404

开发环境：React Native 0.67.4、React 17.0.2、Node.js 20.17.0、Xcode 16.0，该依赖来自react-native-maps。

问题原因 #

GoogleMaps 8.4.0的官方下载链接已被移除，导致CocoaPods无法拉取对应资源包；旧版react-native-maps默认依赖这个已失效的版本。

解决方法 #

方法1：强制指定可用的GoogleMaps版本 #

在项目根目录的Podfile中添加以下代码（可放在target '你的项目名' do块内部）：

pod 'GoogleMaps', '8.1.0'

随后执行：

pod install --repo-update

注：8.1.0为经测试可用的稳定版本，也可选择8.x系列其他未失效的版本

方法2：清理CocoaPods缓存并重新安装 #

执行以下命令彻底清理缓存与旧依赖：

pod cache clean --all
rm -rf Pods/
rm Podfile.lock
pod install --repo-update

方法3：升级react-native-maps到兼容RN0.67的稳定版本 #

在package.json中修改react-native-maps的版本为适配RN0.67的最新稳定版（例如0.31.1），然后执行：

npm install
cd ios && pod install --repo-update

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