缓存目录必须显式配置,不能依赖默认值:生产环境需通过cache-dir或COMPOSER_CACHE_DIR指定绝对路径,确保可读写、空间≥1GB,并配合cache-files-maxsize="1G"和cache-files-ttl=31536000使用。

缓存目录必须显式配置,不能依赖默认值
Composer 默认缓存路径由 COMPOSER_HOME 环境变量决定,但该变量在容器、CI 或多用户服务器上极易不可控:Docker 镜像可能挂载空目录到 /root/.composer,CI runner 可能重置 $HOME,导致缓存失效甚至退回到慢速源。生产环境必须用 cache-dir 显式指定绝对路径。
- 在
composer.json中写死:"cache-dir": "/var/cache/composer" - 或通过环境变量统一控制:
COMPOSER_CACHE_DIR=/var/cache/composer - 确保该路径所在文件系统有足够空间(建议 ≥1GB),且对运行用户(如
www-data)可读写
缓存大小与过期策略要匹配部署频率
生产环境通常不频繁执行 composer update,但 composer install 可能高频触发(如蓝绿发布、滚动更新)。若缓存太小或 TTL 过短,会反复下载相同包,拖慢构建。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
cache-files-maxsize建议设为"1G"(不是默认的300M),避免频繁 GC 清理 -
cache-files-ttl设为31536000(1年),比默认 6 个月更稳妥;只要 lock 文件不变,包内容就不会变 - 禁用自动写入缓存?可以,但仅限只读文件系统场景:
"cache-read-only": true,此时需确保缓存目录已预热
Docker 多阶段构建中缓存目录不能跨阶段保留
缓存目录本身不参与最终镜像交付,但它极大影响构建速度。常见错误是把 /var/cache/composer 放进最终镜像,既增大体积又无实际作用。
- 第一阶段(build)中配置
cache-dir到临时路径(如/tmp/composer-cache),并确保该层复用 - 第二阶段(runtime)完全不挂载、不复制缓存目录,只复制
vendor/ - 若用
--from=composer镜像,其缓存目录与项目构建缓存无关,别混淆
跨平台部署时缓存目录权限容易被忽略
Linux 容器内 UID 与宿主机不一致时,挂载的缓存目录可能因权限不足被 Composer 跳过,表现为“缓存未命中”却无报错。
- 检查实际缓存路径的 owner 和 group:
ls -ld /var/cache/composer - 在 Dockerfile 中显式 chown:
RUN mkdir -p /var/cache/composer && chown www-data:www-data /var/cache/composer - 验证是否生效:
composer install -vvv | grep "Using cache"—— 必须看到这行才说明缓存真正启用
cache-dir 写对了,只要路径不可写或用户无权访问,Composer 就静默降级为无缓存模式。

















