Dockerfile命令在容器内无效果：Composer未生成vendor目录

问题根源 #

• 你的docker-compose.yml中，app服务将本地当前目录./挂载到了容器内的/var/www，这会完全覆盖容器构建阶段生成的/var/www目录内容。
• 构建时RUN composer update生成的vendor目录、RUN chmod -R 755 storage/设置的权限，都被本地目录覆盖，导致容器启动后看不到这些内容。

解决方案 #

方案一：移除全目录挂载（推荐） #

如果不需要本地代码实时同步到容器，直接删除docker-compose.yml中app服务的全目录挂载配置：

services:
  app:
    # ...其他原有配置
    volumes:
      # 移除这一行：- ./:/var/www
    # ...其他原有配置

容器会直接使用构建阶段生成的完整/var/www目录，包含正确生成的vendor和权限设置后的storage。

方案二：选择性挂载必要目录（适合开发环境） #

若需要本地代码实时同步，仅挂载需要修改的目录，避免覆盖vendor和storage：

services:
  app:
    # ...其他原有配置
    volumes:
      - ./app:/var/www/app
      - ./config:/var/www/config
      - ./public:/var/www/public
      - ./resources:/var/www/resources
      - ./routes:/var/www/routes
      - ./composer.json:/var/www/composer.json
      - ./composer.lock:/var/www/composer.lock
      # 用匿名卷存储storage，规避权限冲突
      - storage:/var/www/storage
    # ...其他原有配置

# 添加匿名卷定义
volumes:
  storage:

同时优化Dockerfile，利用构建缓存提升效率：

FROM php:8.1-fpm as php

USER root
WORKDIR /var/www

# 保留原有PHP依赖、扩展安装命令
RUN apt-get update && apt-get install -y \
    git \
    curl \
    libreoffice \
    build-essential \
    libpng-dev \
    libjpeg62-turbo-dev \
    libfreetype6-dev \
    locales \
    zip \
    jpegoptim optipng pngquant gifsicle \
    vim \
    unzip \
    libonig-dev \
    libzip-dev

RUN apt-get clean && rm -rf /var/lib/apt/lists/*

RUN docker-php-ext-install mbstring zip exif pcntl
RUN docker-php-ext-configure gd --enable-gd --with-freetype=/usr/include/ --with-jpeg=/usr/include/
RUN docker-php-ext-install gd

# 先复制composer配置文件，利用缓存
COPY composer.json composer.lock ./

# 安装composer并执行依赖更新
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
RUN composer update --no-interaction --prefer-dist

# 再复制完整源代码
COPY . .

# 设置storage目录权限
RUN chmod -R 755 storage/

EXPOSE 9000
CMD ["php-fpm"]

方案三：启动时修复权限（针对本地挂载storage的场景） #

如果必须挂载本地storage目录，可在容器启动时重新设置权限：

services:
  app:
    # ...其他原有配置
    command: sh -c "chmod -R 755 /var/www/storage && php-fpm"

验证步骤 #

1. 重新构建镜像：docker-compose build --no-cache
2. 启动容器：docker-compose up -d
3. 进入容器检查：
   • 执行docker exec -it app ls /var/www，确认vendor目录存在
   • 执行ls -l /var/www/storage，确认目录权限为755

内容的提问来源于stack exchange，提问作者Vüsal Hüseynli