Docker部署Laravel：composer依赖容器不可用及storage权限问题

核心问题分析 #

1. 文件缺失（vendor/.env）：docker-compose.yml中把宿主机./web/point1目录直接挂载到容器内/var/www/html，会完全覆盖镜像构建阶段生成的vendor、.env等文件——因为宿主机目录没有这些内容，容器启动后自然看不到。
2. storage权限问题：挂载后的目录权限继承自宿主机，和容器内创建的www用户不匹配；且Dockerfile中存在用户不一致（创建了www用户却给www-data授权）的问题。

分步修复方案 #

一、解决vendor/.env文件缺失问题 #

方案1：调整挂载策略（推荐生产环境）

不要挂载整个项目目录，只挂载需要持久化/修改的核心目录，避免覆盖镜像中预构建的依赖和配置：
修改docker-compose.yml中web服务的volumes：

volumes:
  - ./web/point1/app:/var/www/html/app
  - ./web/point1/config:/var/www/html/config
  - ./web/point1/resources:/var/www/html/resources
  - ./web/point1/routes:/var/www/html/routes
  - ./web/point1/storage:/var/www/html/storage
  - ./web/point1/.env:/var/www/html/.env  # 先在宿主机复制.env.example为.env并配置
  - ./scripts/php/local.ini:/usr/local/etc/php/conf.d/local.ini

这样镜像中构建的vendor、bootstrap/cache等目录会保留，不会被宿主机覆盖。

方案2：启动阶段动态生成文件（适合开发环境）

把依赖安装、.env初始化逻辑放到容器启动脚本中，避免挂载覆盖的影响：

1. 在项目根目录创建start.sh脚本：

#!/bin/sh
set -e

# 检查vendor目录，不存在则安装依赖
if [ ! -d "vendor" ]; then
    composer install
fi

# 检查.env文件，不存在则初始化
if [ ! -f ".env" ]; then
    cp .env.example .env
    php artisan key:generate
fi

# 确保storage软链接存在
php artisan storage:link --force

# 缓存配置
php artisan config:cache

# 修复权限
chown -R www:www /var/www/html/storage /var/www/html/bootstrap/cache

# 启动php-fpm
php-fpm

2. 修改Dockerfile，添加脚本并设置为启动命令：

FROM php:8.1-fpm-alpine
COPY ./web/point1/ /var/www/html/
WORKDIR /var/www/html

RUN apk update && apk add --no-cache build-base shadow vim curl ...

COPY --from=composer:latest /usr/bin/composer /usr/local/bin/composer
RUN groupadd -g 1000 www
RUN useradd -u 1000 -ms /bin/bash -g www www

# 复制启动脚本
COPY start.sh /usr/local/bin/start.sh
RUN chmod +x /usr/local/bin/start.sh

# 清理apk缓存（替换原Debian系的apt清理命令）
RUN rm -rf /var/cache/apk/*

EXPOSE 9000
CMD ["start.sh"]

3. 保留原docker-compose的挂载配置即可，启动容器时会自动检查并生成缺失的文件。

二、解决storage目录权限问题 #

1. 统一容器内用户权限：修改Dockerfile中的授权命令，把www-data改成你创建的www用户：

RUN chown -R www:www /var/www/html/bootstrap/cache

2. 启动时修复挂载目录权限：上述start.sh脚本已包含权限修复命令，确保容器内www用户拥有storage和bootstrap/cache的读写权。
3. 宿主机预设置权限（可选）：在宿主机执行以下命令，让容器内UID为1000的www用户拥有对应目录权限：

sudo chown -R 1000:1000 ./web/point1/storage ./web/point1/bootstrap/cache

三、其他优化点 #

• 移除Dockerfile中重复的php artisan key:generate命令，保留一次即可。
• 生产环境构建时，composer安装添加--no-dev参数减少镜像体积：RUN composer install --no-dev。
• 移除Dockerfile中无效的RUN rm -rf /var/lib/apt/lists/*命令，替换为Alpine的缓存清理命令：RUN rm -rf /var/cache/apk/*。

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