Permission denied 根本原因是目录属主错配（如为root而非当前用户），而非rwx权限不足；应通过ls -ld检查报错路径归属，用sudo chown -R $USER:$USER修复对应目录，禁用sudo composer install和chmod 777。
Permission denied 不是 Composer 坏了，而是它试图写入的某个路径被操作系统拒绝——根本原因 90% 是目录“主人不对”，不是权限位（rwx）不够。直接看报错里带的完整路径，就能定位病灶。
报错里出现 file_put_contents 或 Writing cache file 怎么定位具体路径
错误行末尾那个绝对路径就是线索，比如：file_put_contents(/home/user/project/vendor/autoload.php) → 查 vendor/；Writing cache file ~/.composer/cache/repo/https---packagist.org/ → 查全局缓存目录；Could not write to /var/www/myapp/composer.lock → 查 composer.lock。
立刻执行这三行命令确认归属：
ls -ld vendor/ls -ld composer.lockls -ld $(composer config --global cache-dir)
只要任意一行输出第三列（属主）不是你当前用户名（$(whoami)），比如显示 root root，问题就坐实了：所有权错配，不是 chmod 能解决的。
sudo chown -R $USER:$USER 修复哪几个关键位置
只修真正被污染的路径，不碰无关目录：
- 项目内：如果
vendor/和composer.lock都是root所有，运行sudo chown -R $USER:$USER vendor/ composer.lock（注意vendor/末尾斜杠不能少） - 全局缓存：若
$(composer config --global cache-dir)输出路径属主为root，运行sudo chown -R $USER:$USER $(composer config --global cache-dir) - 整个
~/.composer被锁死？直接重置：sudo chown -R $USER:$USER ~/.composer，再补一句chmod -R u+rw ~/.composer防 umask 导致子目录不可写
sudo 这里只是临时提权跑 chown，绝不能用来执行 sudo composer install——那是污染源头，会让问题嵌套恶化。
为什么 chmod -R 777 是毒药不是解药
chmod 控制“能不能读写”，chown 才决定“这东西归不归你”。误用 chmod -R 777 会引发真实后果：
-
vendor/bin/phpunit这类可执行文件在 CI 流水线中被直接拒收 - Git 提交时提示
ownership changed，后续 diff 失控 -
composer update可能只失败一半——部分包更新成功、部分卡住，连chown -R都救不回来
更隐蔽的是：某些插件（如 hirak/prestissimo）会在 /tmp 创建 socket 文件后没释放权限，导致后续 composer install --no-plugins 成功，但加回插件就失败。这种场景下，先加 --no-plugins --no-interaction 验证是否插件干扰。
Docker、CI 和 Windows 下的权限脆点
这些环境不报在主流程，但一样中断构建：
- Docker：宿主机 UID 是 1000，容器却以 UID 0（root）运行 → 启动时加
user:1000，或修复时用数字 UID：sudo chown -R 1000:1000 vendor/ - GitHub Actions / GitLab CI：默认非 root 用户，但基础镜像可能让
~/.composer权限混乱 → 流水线开头加mkdir -p .composer-cache && chmod 700 .composer-cache，再设COMPOSER_CACHE_DIR="$PWD/.composer-cache" - Windows：报
Access is denied且路径含%APPDATA%\Roaming\Composer\Cache→ PowerShell 执行icacls "$env:APPDATA\Roaming\Composer\Cache" /grant；更干脆的做法是删掉整个%APPDATA%\Roaming\Composer目录重来
最容易被忽略的是嵌套污染：一次 sudo composer install 可能让 vendor/ 主目录归你，但里面某个子目录（如 vendor/symfony/console）仍是 root 所有——ls -la vendor/ | grep root 能快速揪出漏网之鱼。
