Docker部署Laravel遇storage目录权限拒绝问题求助

问题根源 #

你之前尝试的chmod 777无效的核心原因：

• Dockerfile中修改权限的命令在挂载本地卷后会被覆盖，容器启动后实际使用的是宿主机./src目录的权限。
• WSL中修改权限后，容器内php-fpm的运行用户（默认是www-data，UID=33）和宿主机目录的所有者（WSL普通用户UID=1000）不匹配，导致读写权限被拒绝。

有效解决方案 #

方案1：统一容器与宿主机用户ID（推荐开发环境）

通过修改php容器内www-data用户的UID/GID，使其与WSL宿主机用户一致，从根源解决权限不匹配问题：

1. 先在WSL终端执行以下命令，获取你的用户UID和GID：

id -u  # 输出如1000
id -g  # 输出如1000

2. 修改dockerfiles/php.Dockerfile：

FROM php:8.2-fpm-alpine

WORKDIR /var/www/laravel

# 安装shadow工具用于修改用户ID，然后将www-data的UID/GID改为宿主机用户的ID
RUN apk add --no-cache shadow && \
    usermod -u 1000 www-data && \
    groupmod -g 1000 www-data

RUN docker-php-ext-install pdo pdo_mysql

# 提前创建storage必要子目录并赋予www-data权限
RUN mkdir -p storage/framework/views storage/framework/sessions storage/framework/cache && \
    chown -R www-data:www-data /var/www/laravel/storage

3. 重新构建php镜像并重启容器：

docker-compose build php
docker-compose up -d

方案2：容器内直接修复权限（快速临时解决）

进入运行中的php容器，直接修改挂载目录的所有权：

# 进入php容器
docker-compose exec php sh

# 赋予www-data对storage目录的所有权
chown -R www-data:www-data /var/www/laravel/storage

# 设置安全的权限（目录755，文件644）
chmod -R 755 /var/www/laravel/storage

方案3：完善Laravel存储配置

确保Laravel的存储链接和配置正确：

# 创建存储软链接
docker-compose exec artisan storage:link

# 清除配置缓存
docker-compose exec artisan config:clear

注意事项 #

• 避免使用777权限，这会带来严重的安全风险，正确的权限配置是目录755 + 文件644，配合所有者匹配即可满足读写需求。
• 如果使用Docker Desktop for Windows的WSL2后端，确保WSL目录的权限映射正确，不要使用Windows文件系统的目录（如/mnt/c）挂载到容器，优先使用WSL内部的目录（如~/projects/laravel）。

内容的提问来源于stack exchange，提问作者Lui Wei Hon