WSL环境下Docker化Laravel应用遇Composer安装失败求助

以下是针对构建卡主问题的具体修复步骤：

1. 优化Dockerfile构建逻辑，利用缓存加速 #

当前Dockerfile先复制全量代码再执行composer install，只要项目文件有改动就会重复执行依赖安装，既低效又易出现缓存异常。调整文件顺序，优先处理Composer相关逻辑：

FROM php:8.2-cli

# 安装系统依赖及PHP扩展
RUN apt-get update && apt-get install -y \
    unzip \
    libpng-dev \
    libjpeg-dev \
    libfreetype6-dev \
    libzip-dev \
    libxml2-dev \
    zip \
    curl \
    && docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install pdo pdo_mysql gd zip mbstring xml

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

# 设置工作目录
WORKDIR /var/www

# 优先复制Composer配置文件，复用Docker缓存
COPY composer.json composer.lock* ./

# 配置国内Composer镜像，解决网络拉取慢问题
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

# 安装项目依赖
RUN composer install --no-interaction --optimize-autoloader --no-dev

# 复制完整项目代码
COPY . .

# 调整目录权限，避免Composer写入权限错误
RUN chown -R www-data:www-data /var/www

CMD ["php", "artisan", "serve", "--host=0.0.0.0", "--port=8000"]

2. 解决网络拉取异常问题 #

如果是网络环境导致的卡主，可通过构建参数指定代理（适配WSL的代理设置）：

docker-compose build --build-arg HTTP_PROXY=http://你的代理地址:端口 --build-arg HTTPS_PROXY=http://你的代理地址:端口

3. 修正docker-compose.yml的配置问题 #

你的APP_KEY为空会导致Laravel启动失败，同时补充数据库连接配置：

version: "3.8"

services:
  app:
    build: .
    container_name: laravel_app
    working_dir: /var/www
    volumes:
      - .:/var/www
    ports:
      - "8000:8000"
    depends_on:
      - db
    environment:
      - APP_ENV=local
      - APP_DEBUG=true
      - DB_CONNECTION=mysql
      - DB_HOST=db
      - DB_PORT=3306
      - DB_DATABASE=laravel
      - DB_USERNAME=laraveluser
      - DB_PASSWORD=secret
    command: >
      sh -c "php artisan key:generate && php artisan serve --host=0.0.0.0 --port=8000"

  db:
    image: mysql:8
    container_name: laravel_db
    restart: unless-stopped
    environment:
      MYSQL_DATABASE: laravel
      MYSQL_ROOT_PASSWORD: root
      MYSQL_USER: laraveluser
      MYSQL_PASSWORD: secret
    ports:
      - "3306:3306"
    volumes:
      - dbdata:/var/lib/mysql
    command: --default-authentication-plugin=mysql_native_password # 兼容MySQL 8认证机制

  phpmyadmin:
    image: phpmyadmin/phpmyadmin
    container_name: laravel_phpmyadmin
    restart: unless-stopped
    depends_on:
      - db
    environment:
      PMA_HOST: db
      MYSQL_ROOT_PASSWORD: root
    ports:
      - "8080:80"

volumes:
  dbdata:

4. 清理Docker构建缓存 #

若旧缓存导致异常，清理后重新构建：

docker system prune -af
docker-compose build --no-cache

私有依赖包的额外处理 #

如果项目依赖GitHub私有包，需在构建时注入SSH密钥：
在Dockerfile开头添加：

ARG SSH_PRIVATE_KEY
RUN mkdir -p /root/.ssh && echo "$SSH_PRIVATE_KEY" > /root/.ssh/id_rsa && chmod 600 /root/.ssh/id_rsa && ssh-keyscan github.com >> /root/.ssh/known_hosts

构建时执行：

docker-compose build --build-arg SSH_PRIVATE_KEY="$(cat ~/.ssh/id_rsa)"

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