安装Laravel时JSON文件下载失败问题咨询

问题回顾 #

你在执行 create-project laravel/laravel "foldername" 创建Laravel项目时遇到了以下错误：

[Composer\Downloader\TransportException] 无法下载文件 "http://packagist.org/p/illuminate/console%241d2f57f687204b9a57e5848fe9f49e79bc2fb7ed0cafc6d1387ad4760a1b155c.json"（HTTP/1.1 404 Not Found）

结合你提供的composer.json来看，你要创建的是Laravel 5.4版本的项目，下面我来拆解这个错误的原因和对应的解决步骤。

错误原因分析 #

这个错误的核心是Composer 无法从 Packagist 仓库获取到 illuminate/console 包的指定元数据文件，具体原因可能有这几点：

• Packagist 临时同步异常：Packagist 作为Composer的默认包仓库，偶尔会出现旧版本包的元数据文件临时丢失或同步延迟的情况，尤其是Laravel 5.4这种已经停止维护多年的版本，仓库对它的支持优先级较低。
• 本地 Composer 缓存失效：你本地的Composer缓存里可能存储了过期的包地址，导致请求了一个已经不存在的文件路径。
• 网络访问问题：网络波动或者你的网络环境无法正常访问Packagist的部分资源，导致请求返回404。

解决方案 #

按以下步骤逐一尝试，应该能解决问题：

1. 清除本地Composer缓存

先清理掉本地过期的缓存，让Composer重新从仓库拉取最新的包信息：

composer clear-cache

2. 在现有项目目录下重新安装依赖

既然你已经有了Laravel项目结构文件，直接进入项目目录执行：

composer install --prefer-dist

--prefer-dist参数会优先下载预编译的压缩包，减少对元数据文件的依赖，能有效避免这类404问题。

3. 切换国内Composer镜像（针对网络问题）

如果是网络访问Packagist不稳定，可以切换到国内的镜像源，比如阿里云镜像：

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

配置完成后再重新执行composer install。

4. 建议升级Laravel版本（可选但推荐）

Laravel 5.4在2018年就已经停止了所有安全更新和维护，不仅容易遇到包仓库的问题，还存在潜在的安全风险。如果你的项目没有强制要求使用旧版本，建议升级到较新的稳定版本（比如10.x或11.x），这样能避免很多旧版本带来的兼容性和维护问题。

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