Dockerfile中composer install安装的依赖未保存的问题求助

核心问题排查 #

你遇到的情况是镜像构建时依赖明明安装成功，但启动容器后vendor目录不见，大概率是以下两个原因之一：

1. Dockerfile的COPY命令覆盖了容器内的vendor #

你的Dockerfile执行顺序是：先复制composer.*安装依赖生成vendor，再执行COPY . /var/www/html把本地克隆的项目（无vendor，因为Git仓库不会提交这个目录）复制到容器目录。虽然Docker的COPY不会主动删除容器内原有文件，但如果本地项目根目录的构建上下文存在干扰（比如.gitignore的间接影响），会导致已生成的vendor被覆盖。

2. Docker Compose挂载了本地目录到容器的/var/www/html #

如果你的docker-compose.yml里配置了类似- .:/var/www/html的volume挂载，启动容器时本地目录会直接覆盖容器内的/var/www/html目录，本地没有的vendor自然在容器里也看不到。

对应解决方案 #

针对COPY覆盖问题：优化Dockerfile与构建上下文 #

1. 添加.dockerignore文件：在项目根目录创建.dockerignore，写入以下内容，避免COPY时带入无关内容或干扰容器内的vendor：

vendor/
var/cache/
var/log/
docker/
.git/

2. 调整Dockerfile的COPY顺序：保留composer缓存优化的同时，确保完整代码复制不会覆盖已安装的vendor：

ARG PHP_VERSION=8.1
ARG APP_ENV=dev

FROM php:${PHP_VERSION}-fpm-alpine AS app_php

# 省略系统依赖、扩展、Composer安装等步骤...

WORKDIR /var/www/html

ENV COMPOSER_ALLOW_SUPERUSER=1
ENV PATH="${PATH}:/root/.composer/vendor/bin"

COPY --from=composer:2 /usr/bin/composer /usr/bin/composer

# 先复制composer文件做缓存
COPY composer.* symfony.* ./
RUN set -eux; \
if [ -f composer.json ]; then \
    composer install --prefer-dist --no-dev --no-autoloader --no-scripts --no-progress; \
    composer clear-cache; \
fi

# 再复制完整项目文件（因为有.dockerignore，不会覆盖vendor）
COPY . /var/www/html
RUN rm -Rf docker/

# 后续的autoload生成、权限配置等步骤...
RUN set -eux; \
mkdir -p var/cache var/log; \
if [ -f composer.json ]; then \
    composer dump-autoload --classmap-authoritative --no-dev; \
    composer dump-env prod; \
    composer run-script --no-dev post-install-cmd; \
    chmod +x bin/console; sync; \
fi

EXPOSE 8000

针对Volume挂载问题：调整挂载策略 #

如果是开发环境需要挂载本地目录实时修改代码，不要挂载整个/var/www/html，只挂载需要修改的核心目录：

# docker-compose.yml示例
services:
  app:
    build: .
    volumes:
      - ./src:/var/www/html/src
      - ./templates:/var/www/html/templates
      - ./public:/var/www/html/public
      - ./translations:/var/www/html/translations
      # 保留容器内的vendor、var目录，避免被本地覆盖

如果必须挂载整个目录，只能在容器启动后手动执行composer install，但这种方式每次启动都要安装，不推荐用于生产环境。

验证方法 #

构建镜像后，先不启动容器，直接运行镜像进入查看：

docker run --rm -it <你的镜像名> bash

检查/var/www/html下是否有vendor目录，如果有，说明是Volume挂载导致的问题；如果没有，说明是Dockerfile的COPY逻辑有问题。

内容的提问来源于stack exchange，提问作者Daniel Richter