Laravel 10中Spatie Browsershot生成PDF的权限异常问题

问题根源 #

通过浏览器访问时，代码以www-data用户（php-fpm运行用户）执行，该用户无权限在/var/www目录下创建snap文件夹；而root用户执行Tinker时拥有系统级权限，因此功能正常。

解决方案 #

方法1：指定自定义用户数据目录给Browsershot #

在生成PDF的代码中，手动指定一个www-data有权访问的用户数据目录（比如项目storage下的专属文件夹）：

use Spatie\Browsershot\Browsershot;

// 生成PDF的代码示例
Browsershot::url('https://your-website-url.com')
    ->setChromeArguments([
        '--user-data-dir=' . storage_path('app/puppeteer-user-data')
    ])
    ->save(storage_path('app/public/generated.pdf'));

然后创建该目录并设置正确权限：

# 创建目录
mkdir -p /var/www/mywebsite/storage/app/puppeteer-user-data
# 设置所属用户组
chown -R www-data:www-data /var/www/mywebsite/storage/app/puppeteer-user-data
# 设置目录权限
chmod -R 755 /var/www/mywebsite/storage/app/puppeteer-user-data

方法2：确保storage目录整体权限正确 #

确认项目storage目录的权限足够让www-data读写：

chown -R www-data:www-data /var/www/mywebsite/storage
chmod -R 755 /var/www/mywebsite/storage

方法3：调整Chrome的启动参数（可选） #

如果上述方法无效，可以添加额外的Chrome启动参数来规避用户目录问题：

Browsershot::url('your-url')
    ->setChromeArguments([
        '--no-sandbox',
        '--disable-dev-shm-usage',
        '--user-data-dir=' . storage_path('app/puppeteer-user-data')
    ])
    ->save('path/to/pdf');

注：--no-sandbox参数会关闭Chrome的沙箱模式，仅在信任环境中使用。

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