RNMapbox Maps 在 iOS 中 Pod 安装失败的解决方案

在 React Native 项目中使用 RNMapbox Maps 时，iOS 端可能会遇到 Pod 安装失败的问题。本文将详细分析问题原因并提供完整的解决方案。

问题现象

开发者在配置 RNMapbox Maps 后，执行 pod install 时出现 401 未授权错误。尽管已按照文档配置了 .netrc 文件并设置了正确的权限，问题仍然存在。

根本原因分析

经过深入排查，发现该问题与 macOS 系统自带的 curl 工具有关。旧版本的 curl 在处理 .netrc 文件认证时存在已知问题，导致无法正确传递 Mapbox 的认证凭据。

完整解决方案

第一步：验证基础配置

1. 确保已在用户目录创建 .netrc 文件
2. 文件内容格式应为：

machine api.mapbox.com
login mapbox
password YOUR_SECRET_TOKEN

3. 设置正确的文件权限：

chmod 600 ~/.netrc

第二步：升级 curl 工具

1. 通过 Homebrew 安装最新版 curl：

brew install curl

2. 确保系统使用新版 curl：

which curl

3. 如果路径不是 /usr/local/opt/curl/bin/curl，需要调整 PATH 环境变量

第三步：清理并重试

1. 删除 Pods 目录和 Podfile.lock 文件
2. 清除缓存：

pod cache clean --all

3. 重新执行 pod install

注意事项

1. Mapbox 访问令牌必须具有 Downloads:Read 权限
2. 确保 .netrc 文件中没有多余的空格或特殊字符
3. 在团队开发环境中，需要确保所有开发成员的机器都进行了相同的配置

通过以上步骤，可以彻底解决 RNMapbox Maps 在 iOS 项目中因认证问题导致的 Pod 安装失败问题。