iOS环境下Flutter集成mapbox-gl执行pod install时401错误排查

可能的遗漏配置及修复步骤 #

• 检查Flutter触发pod install的环境变量
  Flutter执行pod install时可能未读取到用户目录下的.netrc文件，尤其是通过Homebrew、ASDF等工具安装Flutter，或终端环境变量存在差异时。可以手动进入项目的iOS目录执行pod install，若手动执行正常，说明是Flutter启动时的环境问题，尝试重启IDE（Android Studio/VS Code），确保IDE继承当前用户的环境变量。

• 验证.netrc文件格式与权限
  确保.netrc格式无语法错误，正确格式如下：

  machine api.mapbox.com
  login mapbox
  password sk_你的下载权限密钥
  

  注意：login必须是mapbox，不可填写个人用户名；密钥需确认带有Download:read权限，无多余空格或换行。同时执行chmod 600 ~/.netrc，确保仅当前用户可读取该文件。

• 手动配置iOS Podfile的Mapbox源
  部分场景下Flutter的pod集成无法自动识别Mapbox私有源，需手动在ios/Podfile顶部添加：

  source 'https://cdn.cocoapods.org/'
  source 'https://github.com/mapbox/mapbox-cocoapods-specs.git'
  

  若.netrc仍不生效，可临时在Podfile中添加认证配置验证：

  pre_install do |installer|
    installer.pod_targets.each do |target|
      if target.name.start_with?('mapbox')
        target.specs.each do |spec|
          spec.source = {
            :git => 'https://github.com/mapbox/mapbox-gl-native-ios.git',
            :tag => spec.version.to_s,
            :http => {
              :authorization => 'Bearer sk_你的下载权限密钥'
            }
          }
        end
      end
    end
  end
  

• 清理缓存消除配置残留
  执行以下命令清理Flutter与CocoaPods缓存：

  flutter clean
  rm -rf ios/Pods ios/Podfile.lock
  pod repo update
  flutter pub get
  

• 检查Xcode账号与配置冲突
  确认Xcode的Preferences > Accounts中无冲突的Mapbox账号配置，同时检查Xcode项目Build Settings中手动配置的Mapbox密钥，确保与.netrc中的密钥一致。

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