使用cweagans/composer-patches报错：文件存在却提示找不到

问题分析 #

报错提示找不到vendor/composer/composer/src/Composer/Repository/CompositeRepository.php，但实际可通过nano命令打开该文件，且你提供的补丁是针对ArrayRepository.php的——说明问题大概率出在另一个待应用的补丁文件或补丁配置上，而非当前展示的这个补丁。

排查与解决步骤 #

• 检查所有补丁文件的路径正确性
  确保每个补丁文件头部---和+++行的文件路径，与项目中实际文件的路径完全一致，注意大小写（Linux/macOS系统大小写敏感）。比如针对CompositeRepository.php的补丁，可能存在拼写错误、路径层级错误（多/少目录层级）。

• 单独测试单个补丁
  先注释掉composer.json中另一个补丁的配置，只应用你提供的ArrayRepository.php补丁，验证是否能正常执行。如果正常，再单独测试CompositeRepository.php对应的补丁，定位问题源。

• 验证补丁生成格式
  补丁需通过git diff或diff -u生成，确保路径是相对项目根目录的，而非绝对路径或其他相对路径。避免补丁生成时的路径上下文与当前项目不一致。

• 清除Composer缓存
  执行以下命令清除缓存后重试：

  composer clear-cache
  

• 检查composer.json的补丁配置
  确认extra.patches中的配置是否正确，包名（如composer/composer）、补丁文件路径均无错误。示例配置：

  "extra": {
      "patches": {
          "composer/composer": {
              "Add return type hint to count method": "patches/array-repository-count-return-type.patch",
              "Fix CompositeRepository issue": "patches/composite-repository-fix.patch"
          }
      }
  }
  

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