如何下载easyBI报表PDF文件？API报错及Selenium认证问题求助

核心排查与修复步骤 #

• 查看easyBI日志定位根因
  报错提示明确指向日志文件，直接到Jira服务器的日志目录（通常是JIRA_INSTALL/logs/eazybi.log或JIRA_HOME/logs/eazybi.log）查看详细报错信息。PDF生成失败常见原因包括：依赖工具缺失、报表渲染异常、服务器权限不足、内存分配不够等，日志会给出具体线索。

• 验证PDF生成依赖工具（wkhtmltopdf）
  easyBI生成PDF依赖wkhtmltopdf工具，需确认：

  1. 服务器已安装与easyBI版本兼容的wkhtmltopdf
  2. 在服务器终端执行wkhtmltopdf --version，确认工具能正常运行
  3. 手动测试工具功能：用wkhtmltopdf https://example.com test.pdf生成简单PDF，验证工具本身无问题
     若工具缺失或版本不匹配，重新安装对应版本并确保其在系统PATH中可被调用

• 检查API权限与请求参数
  尽管CSV/XLS导出正常，PDF导出可能有额外要求：

  • 确认发起API请求的用户账号拥有easyBI的PDF导出权限（在easyBI权限设置中单独配置）
  • 核对请求URL中的参数（如账户ID、报表ID）是否正确，无遗漏或错误

优化Selenium免认证的方案 #

如果必须用Selenium生成PDF，可避免每次认证：

• 使用Jira API令牌做HTTP Basic认证
  生成Jira API令牌后，将用户名+令牌做Base64编码，在Selenium请求时添加Authorization请求头，格式为Basic <base64编码字符串>
• 复用认证Cookie
  首次登录后，提取浏览器的认证Cookie（如JSESSIONID），后续启动Selenium时直接加载该Cookie，跳过登录流程
• Headless Chrome命令行导出
  直接用Headless Chrome命令行导出PDF，配合Cookie文件实现免认证，示例命令：

  chrome --headless --disable-gpu --print-to-pdf=output.pdf --cookie-file=auth_cookies.txt https://your-eazybi-report-page-url
  

报错信息原文：
Please visit the eazyBI for Jira installation and setup documentation page and check setup instructions or see the Troubleshooting section for the log files location.

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