根本原因是Composer缓存未持久化，每次容器重建导致重复下载解压；应挂载命名卷到COMPOSER_CACHE_DIR并确保UID匹配，构建时用BuildKit cache mount加速。
为什么 composer install 在容器里每次都很慢？
根本原因是 Composer 默认把 vendor/ 和全局缓存（如 ~/.composer/cache）都放在容器临时文件系统里。每次重建容器或运行新实例，缓存全丢，所有包重新下载解压，尤其带 ext-* 扩展的包还会触发反复编译。
用命名卷挂载 COMPOSER_CACHE_DIR 是最简方案
Docker 命名卷比绑定宿主机路径更可靠：不依赖宿主机目录权限、跨平台一致、自动生命周期管理。关键不是挂 vendor/（它应由 composer install 生成在工作目录），而是挂 Composer 自己的下载缓存目录。
- 默认缓存路径是
/root/.composer/cache（root 用户）或/home/www-data/.composer/cache（www-data 用户） - 通过环境变量
COMPOSER_CACHE_DIR显式指定更安全，避免用户差异 - 必须确保该路径所在目录可写，且与容器内用户 UID 匹配（例如 Alpine 镜像常用
www-dataUID 82）
docker run -it \ -v composer-cache:/tmp/composer-cache \ -e COMPOSER_CACHE_DIR=/tmp/composer-cache \ -w /app \ -v $(pwd):/app \ php:8.2-cli \ composer install --no-dev --optimize-autoloader
Dockerfile 中提前复制 composer.json + lock 再安装，才能利用构建缓存
很多人直接 COPY . . 导致每次改代码都让 composer install 步骤失效。正确顺序是：只复制依赖声明文件 → 运行安装 → 再复制其余代码。这样只要 composer.lock 不变，Docker 构建时就能复用上层镜像的 vendor/。
-
composer install必须加--no-interaction（CI 环境无 TTY） - 生产镜像建议加
--no-dev --optimize-autoloader减小体积、提升加载速度 - 若项目用
platform配置（如强制"php": "8.2"），需确保基础镜像 PHP 版本匹配，否则安装失败
FROM php:8.2-cli-alpine RUN apk add --no-cache git zip RUN mkdir -p /tmp/composer-cache ENV COMPOSER_CACHE_DIR=/tmp/composer-cache WORKDIR /app COPY composer.json composer.lock ./ RUN composer install --no-interaction --no-dev --optimize-autoloader COPY . . CMD ["php", "index.php"]
多阶段构建中缓存卷不生效？那是你没在 build 阶段复用缓存
构建阶段（build）的命名卷对运行阶段（final）不可见。想在构建时加速，得用 docker build --cache-from 或 BuildKit 的 cache mount，而不是运行时卷。
- 启用 BuildKit：
DOCKER_BUILDKIT=1 docker build ... - 在
RUN指令中用--mount=type=cache挂载 Composer 缓存目录 - 注意：BuildKit cache mount 默认不持久化到镜像，仅加速当前构建；若需跨构建复用，得配合
--cache-to推送远程缓存
FROM php:8.2-cli-alpine AS builder
RUN apk add --no-cache git zip
WORKDIR /app
COPY composer.json composer.lock ./
RUN --mount=type=cache,target=/tmp/composer-cache,id=composer-cache \
COMPOSER_CACHE_DIR=/tmp/composer-cache \
composer install --no-interaction --no-dev --optimize-autoloader
FROM php:8.2-cli-alpine
COPY --from=builder /app/vendor /app/vendor
COPY . /app
缓存机制本身不难，但容易卡在用户权限、路径所有权、以及混淆「构建缓存」和「运行时卷缓存」这三件事上。特别是 Alpine 镜像里 www-data 用户默认 UID 是 82，而宿主机挂载卷常属 root，不显式 chown 就会写入失败——这个点几乎每次都会漏。 
