根本原因是UID/GID不一致：宿主机用户（如1000）与容器内运行用户（如root或www-data）身份不匹配，导致挂载的~/.composer/cache目录权限拒绝写入。
为什么挂载宿主机 ~/.composer/cache 到容器会 Permission denied
根本原因是 UID/GID 不一致：宿主机用户是 1000，而容器内默认用 root（0）或 www-data（33）运行 composer install，导致缓存目录权限拒绝。Composer 在写入 cache/files/ 或 cache/repo/ 时直接报 file_put_contents(/tmp/cache/xxx): Permission denied，而不是慢或超时。
常见现象包括：Failed to write cache file、Could not scan for classes（因 classmap 缓存写失败）、甚至 curl error 23（因部分 HTTP 响应体缓存写入中断）。
- 别用
docker run -v $HOME/.composer/cache:/root/.composer/cache—— 宿主机路径属主是你的用户，容器里却以 root 尝试写入，但目录权限通常是drwx------，root 也进不去 - 即使改用
chmod 777 ~/.composer/cache，下次 Composer 自动清理时可能因 umask 写出 600 权限文件，又卡住 - CI 环境（如 GitHub Actions）根本没
~/.composer目录，挂载会静默失败，日志里只显示 “cache dir not writable”
正确复用 Composer 缓存的两种可靠方式
真正能跨构建复用、又不碰权限雷区的做法只有两个：靠 Docker 构建缓存本身，或用命名卷隔离可写路径。
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- 在多阶段构建中，把
composer.json和composer.lock单独COPY到构建阶段开头，再跑composer install --no-dev --prefer-dist—— 只要这两个文件不变，Docker 就复用上一次的 vendor 层，根本不需要外部缓存 - 若需开发时加速（比如反复
composer update），用命名卷替代挂载：docker volume create composer-cache，然后在RUN指令中设ENV COMPOSER_CACHE_DIR /tmp/composer-cache并COPY --from=cache-builder /tmp/composer-cache /tmp/composer-cache - 绝对不要在
docker run时用-v挂载宿主机~/.composer/cache；如果非得共享，先在容器启动前chown -R 1001:1001 $HOME/.composer/cache（假设容器 USER 是 1001），但依然不如命名卷稳定
挂载 vendor 目录到命名卷反而更危险
有人试图用 docker run -v composer-vendor:/app/vendor 让 vendor 持久化，结果 composer install 报 vendor/autoload.php is not writable 或反复重建 autoload 文件——因为 vendor 目录被卷接管后，Composer 的文件时间戳、符号链接和权限校验逻辑全乱了。
- Composer 2.x 默认启用
classmap-authoritative，它依赖 vendor/ 下真实文件结构；命名卷的 inode 行为与本地文件系统不一致，某些操作（如dump-autoload）会静默失败 - 一旦卷里混入旧版包或损坏的 .lock 文件，
composer install可能跳过更新、也不报错，导致运行时类找不到 - 真正该持久化的只有缓存（
cache-dir）和插件数据（plugins-dir），vendor 必须每次构建生成，才符合不可变镜像原则
Dockerfile 中必须显式控制 COMPOSER_CACHE_DIR
官方 PHP 镜像不设 COMPOSER_CACHE_DIR，它会 fallback 到 $HOME/.composer/cache，而容器里 $HOME 往往是 /root 或未定义，造成路径错乱。
- 在
RUN前加ENV COMPOSER_CACHE_DIR /tmp/composer-cache，并确保该路径存在且可写：RUN mkdir -p $COMPOSER_CACHE_DIR && chmod 777 $COMPOSER_CACHE_DIR - 避免用
composer config --global cache-dir—— 这会写进/root/.composer/config.json，而后续非 root 用户（如USER 1001）根本读不到 - 如果你用多阶段构建，第二阶段（运行阶段）完全不需要缓存目录，记得在最终镜像里删掉：
RUN rm -rf /tmp/composer-cache
composer config --global cache-dir 输出的路径，必须和 ENV COMPOSER_CACHE_DIR 一致，否则你配了等于没配。 
