无Sail的Laravel应用Docker环境构建报错：找不到artisan文件

问题根源 #

你当前的Dockerfile只复制了laravel-app/composer.json到工作目录/var/www/html，但artisan和其他Laravel核心文件仍留在本地的laravel-app目录中。执行composer update时，Composer会尝试调用artisan生成自动加载文件，找不到文件就会触发报错。

修正方案 #

方案1：复制整个Laravel项目目录到容器工作目录 #

修改Dockerfile的复制步骤，把本地laravel-app目录的所有内容同步到容器的工作目录，确保artisan和其他核心文件存在：

FROM php:8.1.0-apache
WORKDIR /var/www/html
# 启用URL重写
RUN a2enmod rewrite
# 安装系统依赖库
RUN apt-get update -y && apt-get install -y \
    libicu-dev \
    libmariadb-dev \
    unzip zip \
    zlib1g-dev \
    libpng-dev \
    libjpeg-dev \
    libfreetype6-dev \
    libjpeg62-turbo-dev \
    libpng-dev 
# 复制Composer工具
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
# 安装并配置PHP扩展
RUN docker-php-ext-install gettext intl pdo_mysql gd
RUN docker-php-ext-configure gd --enable-gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j$(nproc) gd
# 复制整个Laravel项目目录到容器工作目录
COPY laravel-app/ .
# 执行Composer安装依赖（推荐用install而非update，保证版本稳定）
RUN composer install --no-dev --optimize-autoloader

方案2：指定Composer命令的工作目录 #

如果需要先单独处理依赖（比如用.dockerignore排除冗余文件），可以先复制Composer相关文件，进入项目子目录执行命令后再同步完整项目：

FROM php:8.1.0-apache
WORKDIR /var/www/html
# 启用URL重写
RUN a2enmod rewrite
# 安装系统依赖库
RUN apt-get update -y && apt-get install -y \
    libicu-dev \
    libmariadb-dev \
    unzip zip \
    zlib1g-dev \
    libpng-dev \
    libjpeg-dev \
    libfreetype6-dev \
    libjpeg62-turbo-dev \
    libpng-dev 
# 复制Composer工具
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
# 安装并配置PHP扩展
RUN docker-php-ext-install gettext intl pdo_mysql gd
RUN docker-php-ext-configure gd --enable-gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j$(nproc) gd
# 复制Composer配置文件到项目子目录
COPY laravel-app/composer* laravel-app/
# 进入项目目录执行依赖安装
RUN cd laravel-app && composer install --no-dev --optimize-autoloader
# 同步完整项目文件到工作目录
COPY laravel-app/ .

额外优化建议 #

• 不要同时执行composer install和composer update：install会严格按照composer.lock的版本安装依赖，构建镜像时用它更稳定；update用于本地更新依赖版本，不适合镜像构建环节。
• 添加--no-dev --optimize-autoloader参数：剔除开发依赖，优化自动加载逻辑，减少镜像体积。
• 创建.dockerignore文件：排除node_modules、.git、storage/logs、vendor等不必要的文件，加快镜像构建速度。

内容的提问来源于stack exchange，提问作者Niloy Rony