Laravel Sail中Intervention Image保存图片遇NotWritableException求助

1. 修正容器内目录所有者 #

Laravel Sail默认以sail用户（UID 1000）运行，手动执行权限命令时容易用错用户。进入容器root终端执行：

sail root-shell
chown -R sail:sail /var/www/html/storage/app/public/car-part-images

确保目标目录及所有子项的所有者是sail用户，而非root或其他用户。

2. 递归设置目录权限 #

仅给父目录设权限可能导致子目录（如/1/）权限不匹配，执行递归权限配置：

sail root-shell
chmod -R 755 /var/www/html/storage/app/public/car-part-images

开发环境下可临时用更宽松的权限测试：

chmod -R 775 /var/www/html/storage/app/public/car-part-images

3. 验证文件系统配置与存储链接 #

检查config/filesystems.php中public磁盘的配置是否正确：

'public' => [
    'driver' => 'local',
    'root' => storage_path('app/public'),
    'url' => env('APP_URL').'/storage',
    'visibility' => 'public',
],

确保已执行存储链接命令：

sail artisan storage:link

4. 统一命令执行上下文 #

不要在容器内用root用户直接运行php artisan，必须通过sail用户上下文执行命令：

sail artisan your:command-name

避免因用户身份不一致导致创建的文件权限冲突。

5. 命令内强制设置目录权限 #

在Artisan命令代码中，创建目录时显式指定权限参数，确保递归生效：

use Illuminate\Support\Facades\File;
use Intervention\Image\Facades\Image;

$targetDir = storage_path('app/public/car-part-images/1');
if (!File::exists($targetDir)) {
    // 第四个参数为true会递归给所有子目录设置权限
    File::makeDirectory($targetDir, 0755, true, true);
}

// 执行图片处理与保存
Image::make($sourcePath)->insert($logoPath)->save($targetPath);

6. 匹配宿主机卷权限映射 #

如果storage目录挂载到宿主机，宿主机的文件权限会影响容器内访问。在宿主机执行：

sudo chown -R 1000:1000 ./storage

将宿主机storage目录的UID/GID设为1000，与Sail容器内sail用户的UID匹配。

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