Composer install报Permission denied主因是属主错配而非镜像或权限数字不足，应先用ls -ld检查vendor/、composer.lock及缓存目录归属，若属主非当前用户则执行sudo chown -R $USER:$USER修复，禁用chmod -R 777。
镜像源配置本身不引发权限问题，真正卡住的是 vendor/ 目录写入、缓存目录归属、以及 vendor/bin 脚本执行权限这三处——它们常被误认为“镜像没切成功”，实际是 Linux 文件系统权限模型在起作用。
为什么 composer install 报 Permission denied 却和镜像无关
错误如 file_put_contents(/home/alex/myapp/vendor/autoload.php): Permission denied 或 Writing cache file ~/.composer/cache/... 失败，本质不是网络或镜像问题，而是当前用户对目标路径没有写权限。Composer 2.x 在 Linux 下 95% 的 Permission denied 都源于属主（owner）错配，而非权限数字（如 755）不够。
- 先运行三行检查：
ls -ld vendor/、ls -ld composer.lock、ls -ld $(composer config --global cache-dir) - 只要任意一行第三列（属主）不是你当前用户名（
$(whoami)），就坐实归属问题 - 禁用
chmod -R 777：它掩盖真实问题，且 CI 工具或安全扫描会直接拒绝 - 正确修复是：
chown -R $USER:$USER vendor/、chown -R $USER:$USER ~/.composer/cache
COMPOSER_CACHE_DIR 环境变量覆盖全局配置导致权限失效
当你用 composer config --global cache-dir /home/$USER/.cache/composer 设置后仍报错，大概率是 COMPOSER_CACHE_DIR 环境变量在生效——它优先级高于 config 设置，且不会校验路径是否存在或是否可写。
Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。
- 验证方式：
echo $COMPOSER_CACHE_DIR；若非空，说明已被覆盖 - CI/CD 中常见于 GitHub Actions 的
env:块、Docker 的-e COMPOSER_CACHE_DIR= - 修复只有两个选择：
• 删除环境变量定义，让 config 生效
• 保留变量，但确保路径存在且属主正确：mkdir -p /path/to/cache && chown $USER:$USER /path/to/cache - 注意：
~不会被 Composer 解析，路径必须是绝对路径
镜像源切换后 vendor/bin 脚本突然不可执行
执行 ./vendor/bin/phpunit 报 Permission denied，但 php vendor/bin/phpunit 可运行，说明文件权限位丢失——这是阿里云等镜像源在解压 dist 包时强制使用 --no-same-permissions 导致的，与你本地配置无关。
- 验证命令：
ls -l vendor/bin/phpunit；若显示-rw-r--r--（无x位），基本锁定为镜像行为 - 临时修复可用：
chmod +x vendor/bin/* 2>/dev/null || true，但 CI 可能因非脚本文件被设为可执行而告警 - 推荐长期方案：在
composer.json的scripts中加 post-install-cmd 钩子，只对is_executable($f) === false的文件补chmod($f, 0755) - 切镜像后旧
vendor/不会自动修复，必须删掉vendor/和composer.lock重装
WSL、Docker、宝塔环境下权限错配的典型场景
这些环境里，chown 常失效或不生效，不是命令错了，而是底层机制限制：
- WSL 下项目放在
/mnt/c/（NTFS 分区）：chown无效，因 NTFS 不支持 uid/gid；应把项目移到~/projects/ - Docker 挂载宿主机目录但未用
-u $(id -u):$(id -g)启动容器：容器内用户无法写入宿主机路径 - 宝塔 WebStation 使用
www用户执行 PHP，但你用普通用户配了composer config -g：配置写进~/.composer，www根本读不到 - CI 脚本清缓存只删
~/.composer，却忽略了已切到$COMPOSER_CACHE_DIR的路径，导致残留旧缓存干扰新镜像
最易被忽略的一点：镜像源（repo.packagist）和缓存/写入权限是完全独立的两层事——换再快的镜像，如果 vendor/ 属主是 root，或者 COMPOSER_CACHE_DIR 指向一个 www-data 无权写的路径，安装照样失败。
