根本原因是composer在非交互终端默认等待用户确认，必须加--no-interaction；正确写法为docker-compose run --rm php composer clear-cache --no-interaction，需注意服务名、--rm参数及权限问题。
docker-compose run 里执行 composer clear-cache 总卡住
根本原因是 Composer 在非交互终端（如 CI、Docker 构建阶段）默认会等待用户确认，直接 hang 住。不加 --no-interaction 就没法往下走。
正确写法是：
docker-compose run --rm php composer clear-cache --no-interaction
注意三点：
-
php是你定义的服务名，需对应 docker-compose.yml 中的 service 名称 -
--rm防止容器退出后残留（尤其在反复调试时） - 如果用的是 root 用户构建镜像，但运行时切到了非 root 用户（比如 www-data），
clear-cache可能因权限失败——先确认缓存目录归属：ls -ld $(composer config --global cache-dir)
CI/CD 构建阶段清理缓存却没释放空间
常见现象：跑完 composer clear-cache --no-interaction，du -sh 查磁盘没变化。问题往往不在命令本身，而在路径和覆盖逻辑。
关键检查点：
minimax-mcp-docker版（适配极空间）
下载
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。
- 确认当前生效的缓存路径是否被
COMPOSER_CACHE_DIR覆盖：composer config --global cache-dir输出是否指向/tmp/composer-cache或 NFS 挂载点？如果是，clear-cache删的是远程路径，本地磁盘当然没反应 -
vcs/目录默认被跳过，但它常占 300–800 MB。必须手动补删：rm -rf $(composer config --global cache-dir)/vcs - 临时 ZIP 文件堆积在
sys_get_temp_dir()（通常是/tmp），clear-cache完全不碰这里——CI 环境里要额外加rm -f /tmp/composer_*.zip
Dockerfile 构建时避免缓存污染的写法
很多人在 Dockerfile 里写 RUN composer install 后立刻 RUN composer clear-cache，结果镜像体积没减小。这是分层机制导致的：前面一层写入的缓存文件仍留在镜像历史中。
真正有效的做法是合并操作、避免中间层残留：
- 把安装和清理放在同一层：
RUN composer install --no-dev --optimize-autoloader && composer clear-cache --no-interaction - 禁用 VCS 缓存（省空间又提速）：
RUN composer config --global cache-vcs false - 设缓存上限防失控（Composer 2.5+）：
RUN composer config --global cache-max-size "300M" - 如果项目只用 dist 包，彻底绕过缓存更干净：
RUN composer install --no-dev --prefer-dist --no-interaction
容器运行时清理缓存影响线上服务吗
不影响。Composer 全局缓存只用于依赖安装/更新过程，跟已运行的 PHP 应用完全无关。你删掉 ~/.composer/cache，Laravel 的 config:cache、Symfony 的 var/cache、OpCache 都不受任何干扰。
但要注意两个边界情况：
- 如果你在容器内执行
composer update，同时另一个进程正在跑clear-cache，可能触发Corrupted cache file报错——这类冲突只能靠串行化操作规避 - 某些老旧插件（如
hirak/prestissimo）会在~/.composer/cache/prestissimo/单独建目录，clear-cache不会清理它，得手动删
最常被忽略的是：清完缓存后首次 composer install 会明显变慢——这不是故障，是它重新下载所有 packages.json 和 ZIP 包的必然代价。别因此误判为清理失败。
