重装 Laravel 项目依赖失败需分层排查：先确认 PHP ≥ 8.1 并启用 ctype、curl、mbstring 等必需扩展；再清理 composer.lock 和 composer clear-cache；更换阿里云镜像、设置超时与内存限制；最后检查 vendor 权限及 PATH 配置。
重装 Laravel 项目依赖失败，通常不是单一原因导致的，而是环境、配置、网络或缓存多个环节叠加的结果。关键在于分层排查：先确认基础运行条件是否满足，再聚焦 Composer 行为本身。
检查 PHP 环境与扩展是否完整
Laravel 10 要求 PHP ≥ 8.1，且必须启用以下扩展：ctype、curl、dom、filter、hash、mbstring、openssl、pcre、pdo、session、tokenizer、xml、zip。缺一不可。
- 运行 php -v 确认版本；用 php -m 查看已启用模块
- Ubuntu/Debian 下可批量安装：sudo apt install php-curl php-mbstring php-xml php-zip php-bcmath php-opcache
- CentOS/RHEL 使用：sudo yum install php-curl php-mbstring php-xml php-zip php-bcmath
- 修改后重启 Web 服务（如 Apache 或 PHP-FPM）
清理 Composer 缓存与锁定文件
composer.lock 文件会固化旧版本依赖关系，而本地缓存可能包含损坏或过期的包数据，这两者常引发“无法解析依赖”错误。
- 删除项目根目录下的 composer.lock 文件
- 运行 composer clear-cache 清除全局缓存
- 若仍失败，可临时禁用 lock 文件逻辑：composer install --ignore-platform-reqs（仅调试用，勿用于生产）
更换镜像源并调高超时与内存限制
国内用户常因网络波动卡在下载阶段，表现为长时间无响应或 “cURL error 28”。
- 设置阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 延长超时时间：composer config -g process-timeout 600
- 绕过内存限制：php -d memory_limit=-1 /usr/bin/composer install
- 优先使用压缩包而非 Git 克隆：composer install --prefer-dist
验证并修复权限与路径问题
Linux/macOS 下，Composer 生成的 vendor 目录若归属错误或权限过严，会导致写入失败；Windows 下则常见 PATH 未包含 Composer bin 目录。
- 确保当前用户对项目目录有读写权限：chmod -R 755 ./（避免直接用 777）
- 检查 ~/.composer/vendor/bin 是否在系统 PATH 中（尤其 Windows 需手动添加到环境变量）
- 若提示 “Permission denied” 执行 artisan 命令，先运行：chmod +x artisan
