Ubuntu下Laravel Sail/Docker创建文件Permission Denied问题求助

核心问题 #

本地Ubuntu用户的UID/GID与Docker容器内运行Sail的用户不匹配，导致创建的文件权限和本地编辑权限冲突。

分步解决方案 #

1. 确认本地用户的UID/GID #

先获取当前登录用户的UID和GID：

id -u  # 输出本地用户UID，默认通常为1000
id -g  # 输出本地用户GID，默认通常为1000

2. 正确配置.env并重启Sail #

确保项目根目录的.env文件中配置匹配本地用户的ID：

WWWUSER=1000  # 替换为上面`id -u`的输出值
WWWGROUP=1000 # 替换为上面`id -g`的输出值

关键操作：修改配置后必须彻底重启Sail容器（删除旧卷避免残留权限干扰）：

./vendor/bin/sail down -v
./vendor/bin/sail up -d

3. 修复现有项目文件权限 #

在本地终端（不要进入容器）执行以下命令，重置项目目录权限为本地用户所有，同时确保容器可正常读写：

# 将项目目录所有权改回本地用户
sudo chown -R $USER:$USER /path/to/your/laravel/project

# 给存储、缓存目录设置组读写权限（容器内用户属于该组）
sudo chmod -R 775 /path/to/your/laravel/project/storage
sudo chmod -R 775 /path/to/your/laravel/project/bootstrap/cache

# 给项目根目录设置setgid位，新创建的文件自动继承目录组权限
sudo chmod g+s /path/to/your/laravel/project

4. 用正确上下文执行Sail命令 #

如果执行artisan命令仍遇权限问题，直接指定容器内的sail用户执行：

./vendor/bin/sail exec --user=sail php artisan make:model Post

这样创建的文件会自动匹配本地用户权限，VS Code编辑时不会出现保存失败问题。

5. 排查VS Code编辑异常 #

• 确保用本地普通用户启动VS Code，而非root用户（root启动的VS Code会以root权限编辑，易引发权限混乱）。
• 若使用VS Code Remote-Containers插件，检查.devcontainer/devcontainer.json中的remoteUser配置是否同步了本地用户UID/GID（Sail默认已处理此配置）。

内容的提问来源于stack exchange，提问作者D. Martin Njuguna