Debian Apache2服务器部署WebApp时pdfkit报Command Failed求助

以下是针对性的排查和解决步骤：

• 指定wkhtmltopdf绝对路径
  Apache的运行环境PATH可能不包含/usr/bin，手动指定可执行文件路径才能确保调用成功。修改代码启用配置项：

  html = template.render(args)
  options = {
      'encoding': "UTF-8"
  }
  name = 'podsumowania/order' + ID + '.pdf'
  # 启用并传入config参数
  config = pdfkit.configuration(wkhtmltopdf='/usr/bin/wkhtmltopdf')
  pdfkit.from_string(html, name, options=options, configuration=config)
  

• 检查文件与目录权限

  • 确保podsumowania目录对Apache运行用户（通常是www-data）有读写权限：

    sudo chown -R www-data:www-data podsumowania
    sudo chmod -R 755 podsumowania
    

  • 如果wkhtmltopdf需要临时目录，可在options中指定有权限的自定义临时目录：

    options = {
        'encoding': "UTF-8",
        'temp-dir': '/var/www/your_app/tmp'  # 替换为你的应用下的临时目录，需给www-data读写权限
    }
    

• 捕获wkhtmltopdf的真实错误输出
  绕过pdfkit的错误屏蔽，直接调用wkhtmltopdf命令获取详细日志：

  import subprocess
  import tempfile
  
  html = template.render(args)
  name = 'podsumowania/order' + ID + '.pdf'
  
  with tempfile.NamedTemporaryFile(mode='w', suffix='.html', encoding='utf-8') as f:
      f.write(html)
      f.flush()
      # 直接执行wkhtmltopdf命令
      proc = subprocess.run(
          ['/usr/bin/wkhtmltopdf', '--encoding', 'UTF-8', f.name, name],
          capture_output=True,
          text=True
      )
      # 打印输出和错误信息
      print("标准输出:", proc.stdout)
      print("错误输出:", proc.stderr)
  

  运行后就能看到真实报错，比如依赖缺失、HTML资源路径错误等。

• 安装wkhtmltopdf无头渲染依赖
  Debian服务器是无头环境，wkhtmltopdf需要额外的图形依赖库才能渲染HTML，执行以下命令安装：

  sudo apt-get update && sudo apt-get install libxrender1 libfontconfig1 libxext6 libssl-dev
  

• 验证HTML内容兼容性
  将渲染后的HTML保存为文件，手动用wkhtmltopdf命令测试转换：

  # 先把html内容保存到test.html
  /usr/bin/wkhtmltopdf --encoding UTF-8 test.html test.pdf
  

  若此命令报错，说明HTML中存在服务器环境不兼容的内容（比如缺失字体、本地资源路径错误），针对性修复即可。

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