Mac环境执行make gen报错：无法识别GitLab仓库URL https://gitlab.myproject/podspecs.git 类型

错误本质说明 #

你看到的报错分为两部分：Couldn't determine repo type for URL是结果，后半段mapping values are not allowed in this context才是根因，属于YAML语法错误。你排查的Podfile是Ruby语法格式，因此即使Podfile配置正确也不会解决这类问题，错误源来自YAML格式的相关配置文件。

排查&解决步骤 #

• 步骤1：定位错误对应的具体文件
  优先单独执行CocoaPods命令排查，过滤make gen封装的冗余日志：
  执行pod install --verbose，查看完整报错中的文件路径、对应行号和列号，直接定位到出问题的YAML文件。如果pod install执行正常，说明问题出在Makefile的gen步骤关联的YAML配置，直接去Makefile对应gen逻辑处排查。
• 步骤2：排查YAML语法高频错误
  YAML语法要求严格，对应报错行优先检查以下问题：
  • 禁止使用Tab缩进，必须使用空格缩进
  • 键值对的冒号后必须加空格，例如source:https://xxx会报错，必须写为source: https://xxx
  • 字段值中包含冒号时，必须给整个值加单引号或双引号转义，例如desc: version:1.0会报错，必须写为desc: "version:1.0"
• 步骤3：排查CocoaPods本地缓存配置
  错误大概率来自本地缓存的podspec源的YAML配置：
  1. 执行pod repo list，找到https://gitlab.myproject/podspecs.git对应的本地源名称，默认一般为podspecs
  2. 进入本地源目录：cd ~/.cocoapods/repos/podspecs，检查所有.yml/.yaml后缀文件，以及各pod版本目录下的YAML格式podspec文件，按照步骤2的语法规则修复对应报错行的问题
• 步骤4：排查项目本地配置文件
  检查项目根目录下的YAML格式文件：
  • Podfile.lock：这是CocoaPods自动生成的YAML文件，如有语法错误可以直接删除该文件，执行pod install重新生成
  • 自定义的YAML格式.podspec文件：检查是否符合语法规则
  • Makefile中gen步骤的内嵌YAML配置或YAML生成脚本：确认生成的YAML语法合规
• 步骤5：重置本地pod源重试
  如果以上排查未发现明显问题，直接移除本地有问题的源重新拉取：

  pod repo remove podspecs
  pod repo add podspecs https://gitlab.myproject/podspecs.git
  pod repo update podspecs
  

  执行完毕后重新运行make gen即可验证问题是否解决。

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