Laravel 10.44执行composer install时spark-stripe授权及依赖报错求助

问题概述 #

克隆Laravel 10.44项目后执行composer install时，遇到以下三类问题：

1. GitHub仓库克隆失败：

   Failed to execute git clone --mirror -- https://ghp...Fd8:x-oauth-basic@github.com/laravel/spark-stripe.git AppData/Local/Composer/vcs/git-github.com-laravel-spark-stripe.git/
   Cloning into bare repository 'AppData/Local/Composer/vcs/git-github.com-laravel-spark-stripe.git'...
   remote: Repository not found.
   fatal: repository 'https://github.com/laravel/spark-stripe.git/' not found
   

2. Spark License验证失败：

   ******************************************************************
   You do not have a valid license to download this release (v4.3.1)!
   ******************************************************************
   
   Failed to download laravel/spark-stripe from dist: The "https://spark.laravel.com/dist/laravel/spark-stripe/laravel-spark-stripe-6502033e85f96852f450fd2861daaa6cd04aa598-zip-c53fe0.zip" file could not be downloaded (HTTP/2 422 ):
   {"warning":"\n\n******************************************************************\nYou do not have a valid license to download this release (v4.3.1)!\n************************************************...
   Now trying to download from source
   

3. Artisan命令无法运行：

   Fatal error: Uncaught Error: Class "Illuminate\Foundation\Application" not found in PhpstormProjects\management\bootstrap\app.php on line 14
   
   Error: Class "Illuminate\Foundation\Application" not found in PhpstormProjects\management\bootstrap\app.php on line 14
   
   Call Stack:
       0.0004     395600   1. {main}() PhpstormProjects\management\artisan:0
       0.0047     501224   2. require_once('PhpstormProjects\management\bootstrap\app.php') PhpstormProjects\management\artisan:20
   

解决方案 #

1. 确认Spark License有效性 #

• 登录Laravel Spark官方后台，检查你的License是否包含v4.3.1版本的授权
• 确认License已绑定当前项目使用的Laravel账号，且授权范围覆盖该项目

2. 修正auth.json认证配置 #

Spark的认证是独立于GitHub的，需在auth.json中配置正确的Spark仓库认证信息：

• 配置文件位置：项目根目录或全局Composer目录（Windows：C:\Users\{你的用户名}\AppData\Roaming\Composer\auth.json；Linux/macOS：~/.composer/auth.json）
• 正确配置格式：

  {
      "http-basic": {
          "spark.laravel.com": {
              "username": "你的Laravel账号邮箱",
              "password": "你的Spark License密钥"
          }
      }
  }
  

• 注意：不要将GitHub OAuth Token与Spark认证信息混淆，两者是独立的认证体系

3. 清理Composer缓存与无效镜像 #

执行以下命令清除缓存和已损坏的VCS镜像：

# 清除Composer全局缓存
composer clear-cache

# 删除Spark-Stripe的无效VCS镜像（Windows用户替换为对应路径）
rm -rf ~/.composer/vcs/git-github.com-laravel-spark-stripe.git/

之后重新执行composer install

4. 解决终端无法输入密码的问题 #

• Windows用户建议使用PowerShell而非CMD，确保终端支持交互式输入
• 直接通过auth.json配置认证信息，避免手动输入密码的交互步骤

5. 临时调试方案（解决Artisan报错） #

如果需要先让项目核心依赖安装完成，可临时注释composer.json中的laravel/spark-stripe依赖，执行composer install安装其他核心依赖，待Artisan可正常运行后，再单独处理Spark的安装（不推荐用于生产环境）

注：Artisan报错的根本原因是Composer未完成核心依赖安装，Illuminate框架类未加载，因此必须先解决Composer的依赖安装问题，才能正常运行Artisan命令

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