使用exec调用wkhtmltopdf无法生成PDF，启用JS时失败求助

这种命令行正常但Web触发执行失败的情况，大概率是权限、环境差异或者JS加载超时/依赖缺失导致的，给你几个实用的排查方向：

• 使用绝对路径并补全权限
  Web服务器（比如Apache/Nginx）的运行用户（通常是www-data或apache）和你命令行的用户权限完全不同，这是最常见的坑：

  1. 用wkhtmltopdf的绝对路径，比如/usr/bin/wkhtmltopdf（可以通过命令行执行which wkhtmltopdf查到具体路径），避免Web环境的PATH找不到命令；
  2. 确保生成PDF的目标目录对Web用户有写入权限，比如执行chown www-data:www-data /your/pdf/storage/dir；
  3. 把URL补全为完整的https://www.yahoo.co.jp，你代码里少了协议头，Web环境下可能无法正确解析地址。

• 调整JS相关超时参数
  从错误日志看进程卡在加载阶段，很大概率是页面JS加载或执行超时。试试添加这些参数：

  • --javascript-delay 5000：等待5秒让JS完全执行后再开始渲染；
  • --timeout 60000：把整体超时时间延长到60秒；
  • --load-error-handling ignore：忽略个别资源加载失败的情况，避免进程卡住。
    修改后的命令示例：

  exec("/usr/bin/wkhtmltopdf --javascript-delay 5000 --timeout 60000 --load-error-handling ignore 'https://www.yahoo.co.jp' /path/to/writable/yahoo.pdf");
  

• 检查Web环境的依赖库
  wkhtmltopdf依赖图形渲染相关的库（比如libX11、libXext、libfontconfig等），命令行环境可能已经安装，但Web服务器的运行环境可能缺失这些依赖：

  1. 在Web环境下执行system("/usr/bin/wkhtmltopdf --version 2>&1", $output);，然后打印$output看有没有依赖报错；
  2. 如果是Ubuntu/Debian系统，安装缺失的依赖：sudo apt-get install libxrender1 libxext6 libfontconfig1 libjpeg-turbo8；
  3. 如果是CentOS/RHEL：sudo yum install libXrender libXext fontconfig libjpeg-turbo。

• 捕获完整错误日志
  把标准输出和错误都捕获下来，能更精准定位问题：

  system("/usr/bin/wkhtmltopdf 'https://www.yahoo.co.jp' yahoo.pdf > full_log.txt 2>&1");
  

  查看full_log.txt里的详细信息，比如有没有特定JS报错、资源加载失败的提示，这些都能帮你找到卡住的具体原因。

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