升级PHP8后Laravel Spatie包转PDF为图片报PDFDelegateFailed错误怎么办

错误根因 #

该错误是Imagick扩展处理PDF时调用依赖的Ghostscript程序失败导致，和PHP版本升降级无关，是重装XAMPP后系统层面的依赖或路径配置失效引发的问题。

1. 安装/修复Ghostscript依赖 #

• 确认你的XAMPP架构（32位/64位），下载对应架构的Ghostscript稳定版（推荐9.5x版本，避免测试版兼容性问题）
• 安装完成后将Ghostscript的bin目录（默认路径示例：C:\Program Files\gs\gs9.56.1\bin）添加到系统PATH环境变量
• 重启电脑让环境变量生效，打开cmd输入对应命令验证安装：
  • 64位环境：gswin64 -v
  • 32位环境：gswin32 -v
    能正常输出版本号即为配置成功

2. 修复Imagick调用适配 #

• Windows环境下Imagick默认调用gs.exe，但Ghostscript默认可执行文件名为gswin64.exe/gswin32.exe，直接进入Ghostscript的bin目录，将原有exe复制一份重命名为gs.exe即可
• 新建phpinfo文件，搜索Imagick板块，确认Imagick supported formats列表中已包含PDF格式，否则回到第一步检查架构匹配和环境变量配置

3. Laravel项目配置校验 #

• 清理项目缓存：依次执行php artisan config:clear、php artisan cache:clear，避免旧路径配置被缓存
• 检查Spatie/pdf-to-image的自定义配置（如果有设置），确认Ghostscript路径和你实际安装路径一致
• 确认Apache运行用户对Ghostscript安装目录、项目临时文件存储目录拥有可读可执行权限

内容的提问来源于stack exchange，提问作者R. M