答案是缓存写入失败主因是~/.composer/cache归属错配或ACL锁死,需用composer config --global cache-dir定位路径,再通过chown -R $USER:$USER(Linux/macOS)或icacls授予权限(Windows)修复,禁用chmod 755。

缓存文件无法写入,90% 是 ~/.composer/cache 目录归属错配或权限锁死,不是磁盘满或网络问题——composer clear-cache 命令本身就会失败,得先手动修目录所有权或 ACL。
确认缓存目录路径和当前归属
别猜路径,直接查:
- 运行
composer config --global cache-dir看输出(Linux/macOS 通常是~/.composer/cache,Windows 是%APPDATA%\Roaming\Composer\Cache) - 接着执行
ls -ld ~/.composer/cache(Linux/macOS)或icacls "%APPDATA%\Roaming\Composer\Cache"(Windows PowerShell) - 如果输出里第三列不是你的用户名(如
alice alice),或 Windows 中显示NT AUTHORITY\SYSTEM或空权限条目,就坐实了归属/ACL 问题
Linux/macOS 下修复缓存目录所有权
错误示范是删完重装,正确做法是归还控制权:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 先删旧缓存:
rm -rf ~/.composer/cache - 重建并设归属:
mkdir -p ~/.composer/cache && sudo chown -R $USER:$USER ~/.composer/cache - 不建议用
chmod 755单独设权限——chown 才解决根本问题;755 是默认值,chown 后自动继承 - WSL 用户务必避开
/mnt/c/路径,所有操作在~/下进行,否则chown不生效
Windows 下修复 %APPDATA%\Roaming\Composer\Cache ACL
图形界面最稳,命令行适合批量部署:
- 右键该文件夹 → “属性” → “安全” → “编辑…” → “添加…” → 输入
%USERNAME%或Users→ 勾选“完全控制” - 管理员 PowerShell 中运行:
icacls "$env:APPDATA\Roaming\Composer\Cache" /grant "$env:USERNAME:(OI)(CI)F" /t - 若仍报错,改用用户级路径:
composer config -g cache-dir "%USERPROFILE%\composer-cache" && mkdir "%USERPROFILE%\composer-cache" - 注意:IIS 或 CLI 运行 PHP 的用户可能不是登录账户(如
IIS_IUSRS),需在 ACL 中显式添加
为什么删了缓存还是 Permission denied?
因为 Composer 在写缓存前会先尝试写临时子目录(如 ~/.composer/cache/repo/https---packagist.org/),而这个路径的父目录权限没同步修复:
- 错误信息里出现
repo/https---或vcs/字样,说明问题不在根缓存目录,而在其子路径 - 必须递归修复整个
~/.composer/cache,不能只修顶层目录 - Windows 下
icacls /t参数不可省;Linux/macOS 下chown -R必须带-R,漏掉就白干 - CI 流水线中若用缓存复用
~/.composer/cache,要确保 runner 用户 UID 与缓存生成时一致,否则chown也救不了

















