Laravel项目中Docker执行COPY index.html命令报错

问题原因 #

你的Dockerfile尝试复制index.html到Nginx目录，但Laravel应用的前端入口是public/index.php，默认不存在静态的index.html文件，导致构建报错。

解决方案 #

根据Laravel的部署需求，有两种常见处理方式：

方式一：正确部署Laravel应用（推荐生产环境） #

Laravel需要PHP环境运行，通常采用Nginx反向代理到PHP-FPM的架构，可通过多阶段构建实现：

1. 修改Dockerfile为多阶段构建：

# 第一阶段：构建Laravel依赖与前端资源
FROM php:8.2-fpm as builder

# 安装必要依赖与PHP扩展
RUN apt-get update && apt-get install -y \
    git \
    zip \
    unzip \
    && docker-php-ext-install pdo_mysql

# 安装Composer
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

# 复制项目文件并安装依赖
COPY . /var/www/html
WORKDIR /var/www/html
RUN composer install --no-dev --optimize-autoloader

# 编译前端资源（使用Vite时执行）
RUN npm install && npm run build

# 第二阶段：配置Nginx
FROM nginx:1.18

# 复制Laravel的public目录到Nginx根目录
COPY --from=builder /var/www/html/public /usr/share/nginx/html

# 复制自定义Nginx配置
COPY nginx.conf /etc/nginx/conf.d/default.conf

2. 创建nginx.conf配置文件（放在项目根目录）：

server {
    listen 80;
    server_name localhost;
    root /usr/share/nginx/html;
    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass php-fpm:9000; # 需与PHP-FPM服务名一致（如docker-compose中的服务名）
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

3. 配合docker-compose使用（可选）：
   创建docker-compose.yml，同时启动PHP-FPM和Nginx服务：

version: '3.8'
services:
  php-fpm:
    build:
      context: .
      target: builder
    volumes:
      - ./:/var/www/html
  nginx:
    build: .
    ports:
      - "80:80"
    depends_on:
      - php-fpm

方式二：临时添加静态index.html（仅测试用） #

如果只是临时测试构建流程，可在项目根目录创建一个简单的index.html文件：

<!DOCTYPE html>
<html>
<head>
    <title>Laravel Test Page</title>
</head>
<body>
    <h1>测试页面</h1>
</body>
</html>

此时Dockerfile的COPY指令即可正常执行，但这不适用于Laravel生产部署。

额外检查 #

确认项目根目录的.dockerignore文件没有意外排除需要的文件（比如public目录或自定义的index.html）。

内容的提问来源于stack exchange，提问作者Tadas V.