Docker环境下Laravel无法写入/var/www/html/public/uploads目录求助

1. 手动调整容器内目录权限 #

先进入运行中的Laravel容器：

docker exec -it <容器ID/名称> bash

然后给uploads目录设置适配Web服务的权限与所属用户（Nginx/PHP-FPM通常以www-data运行）：

chown -R www-data:www-data /var/www/html/public/uploads
chmod -R 755 /var/www/html/public/uploads

执行完成后退出容器，测试上传功能是否恢复。

2. 在Dockerfile中预配置权限 #

如果不想每次启动容器都手动调整权限，可在构建镜像时直接加入权限配置：

# 创建uploads目录并设置权限
RUN mkdir -p /var/www/html/public/uploads \
    && chown -R www-data:www-data /var/www/html/public/uploads \
    && chmod -R 755 /var/www/html/public/uploads

重新构建镜像并启动容器，权限会自动配置完成。

3. 排查宿主机挂载卷的权限问题 #

如果uploads目录是挂载的宿主机目录，宿主机的权限会直接影响容器内的写入：

• 在宿主机找到对应的挂载目录，执行：

chown -R www-data:www-data /宿主机本地的uploads路径
chmod -R 755 /宿主机本地的uploads路径

注：生产环境不建议使用777权限，但可以临时用chmod -R 777 /xxx测试是否是权限导致的问题。

4. 验证Laravel文件系统配置 #

检查config/filesystems.php中的public磁盘配置，确保root路径正确指向uploads目录：

'public' => [
    'driver' => 'local',
    'root' => public_path('uploads'),
    'url' => env('APP_URL').'/uploads',
    'visibility' => 'public',
],

public_path('uploads')会自动解析为容器内的/var/www/html/public/uploads，若自定义了路径需对应调整。

5. 确认PHP-FPM运行用户匹配 #

如果使用PHP-FPM，检查其运行用户是否与Nginx一致（通常为www-data）：
打开PHP-FPM的配置文件（一般是/etc/php/<版本>/fpm/pool.d/www.conf），确保以下配置正确：

user = www-data
group = www-data

若PHP-FPM使用其他用户，需将uploads目录的所属用户改为该用户。

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