根本原因是 Composer 默认缓存目录（如 ~/.composer/cache）属主不匹配或权限不足，常见于 Docker、CI 或 sudo 切换用户场景；应检查并重设缓存路径至当前用户可写目录，如 $HOME/.cache/composer，并确保完整权限。
Composer install 时提示 Failed to write cache file
根本原因是 Composer 默认缓存目录（通常是 ~/.composer/cache）被当前用户锁定或属主不匹配，常见于 Docker 容器、CI 环境或 sudo 后切换用户执行命令的场景。不是所有报错都显示完整路径，但只要看到 cache 和 permission denied 或 failed to write 就基本可定位到这里。
- 先确认当前缓存路径：
composer config --global cache-dir - 检查该路径权限：
ls -ld $(composer config --global cache-dir)，重点看属主和drwx权限位 - 如果属主是
root而你用普通用户运行，就必然失败 —— Composer 不会自动降权重试
临时绕过：用 --no-cache 或改用内存缓存
适用于 CI/CD 流水线或一次性调试，不解决根本问题但能快速跑通流程。注意这会显著拖慢后续依赖安装速度，因为每次都要重新下载 zip 包或 clone。
- 跳过缓存读写：
composer install --no-cache - 用
tmpfs挂载缓存（Docker 场景）：docker run -v /dev/shm:/root/.composer/cache composer install - 强制走 HTTP 缓存（不推荐）：
composer config --global store-auths false，但这只影响凭证，不解决目录权限
永久修复：重设缓存目录并确保属主正确
最稳妥的做法是把缓存挪到当前用户有完全控制权的位置，比如 $HOME/.cache/composer，再配好属主和权限。别直接 chown -R $USER:$USER ~/.composer，那可能破坏全局配置文件的属主逻辑。
- 创建新缓存路径：
mkdir -p $HOME/.cache/composer - 设置归属：
chown -R $USER:$USER $HOME/.cache/composer - 告诉 Composer 新位置：
composer config --global cache-dir "$HOME/.cache/composer" - 验证是否生效：
composer config --global cache-dir输出应为新路径，且ls -ld显示当前用户可写
Docker 中的典型陷阱：用户 UID 不一致
很多基础镜像（如 php:alpine）默认以 root 运行，但挂载宿主机目录后，容器内 root 写入的文件在宿主机上属主变成 root，下次非 root 用户进容器就写不了。这不是 Composer 的 bug，是 Unix 权限模型的必然结果。
- 构建时指定非 root 用户：
RUN addgroup -g 1001 -f www && adduser -S phpuser -u 1001 - 运行时用对应 UID：
docker run -u 1001:1001 -v $(pwd)/.composer:/home/phpuser/.composer php:alpine composer install - 或者干脆在容器内重定向缓存：
ENV COMPOSER_CACHE_DIR=/tmp/composer-cache，配合RUN mkdir -p /tmp/composer-cache
实际修复中，最容易被忽略的是「缓存目录嵌套子目录的权限」——composer install 会在 cache/files/ 下建大量哈希命名的子目录，如果父目录权限宽松但某个子目录被意外 chown 错，就会静默失败。建议修复后手动 rm -rf $COMPOSER_CACHE_DIR/* 再试一次。
