Symfony集成KnpSnappy在Plesk虚拟服务器报重定向过多错误求助

排查步骤 #

• 校验站点运行用户的执行权限
  你在SSH下执行wkhtmltopdf --version正常不代表站点PHP运行用户（Plesk下通常为对应站点专属用户，非root/www-data）有权限执行二进制文件，执行以下命令验证：

  sudo -u <你的站点运行用户名> /usr/local/bin/wkhtmltopdf --version
  

  若返回报错，执行以下命令赋权：

  chmod +x /usr/local/bin/wkhtmltopdf
  chmod +x /usr/local/bin/wkhtmltoimage
  

  同时在Plesk站点的PHP配置中，将/usr/local/bin/、临时目录/tmp加入open_basedir允许路径列表，避免PHP限制二进制调用。

• 排查转换源跳转问题
  如果你调用Snappy时传入的是站点URL（而非直接渲染好的HTML字符串），大概率是以下原因导致循环跳转：

  1. 待转换页面需要登录校验：wkhtmltopdf默认不会携带当前用户的会话Cookie，会被重定向到登录页，若登录页存在跳转逻辑就会触发循环。可以在调用时传入会话Cookie：

     $snappyPdf->setOption('cookie', [
         'PHPSESSID' => $request->cookies->get('PHPSESSID'),
         // 其他你站点用到的会话校验Cookie
     ]);
     

  2. 站点配置了强制HTTPS、www/非www跳转规则：待转换的URL规则不符合跳转要求会触发多次跳转，可以在生成PDF的路由中添加内部访问标识，跳过跳转校验，或直接传入Twig渲染后的HTML字符串作为转换源，避免网络请求。
  3. 避免控制器循环调用：不要在生成PDF的路由逻辑中，再次请求当前路由作为转换源，会直接触发死循环。

• 验证wkhtmltopdf依赖完整性
  仅--version返回正常不代表运行完整转换逻辑无问题，在SSH下手动执行转换测试：

  /usr/local/bin/wkhtmltopdf '<测试用HTML文件路径/公网可访问无跳转的URL>' test.pdf
  

  若执行报错，安装缺失依赖即可：

  apt install libxrender1 libfontconfig1 libxext6
  

• 校验Symfony配置加载
  部署后先清空生产环境缓存，避免旧配置生效：

  php bin/console cache:clear --env=prod
  

  执行以下命令验证Snappy配置是否正确加载：

  php bin/console debug:config knp_snappy
  

  确认返回的binary路径与你.env中配置的路径一致。

• 查看Symfony运行日志
  前端返回的重定向错误是表层表现，优先查看var/log/prod.log中的后端报错信息，可直接定位权限、资源缺失等具体问题。

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