Wkhtmltopdf生成PDF时出现浏览器警告的排查咨询

• 确认提示来源是否为目标网页
  wkhtmltopdf基于旧版WebKit内核，目标网页可能针对旧浏览器弹出提示。直接在Firefox中修改User-Agent为wkhtmltopdf的默认UA（格式类似Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Qt/5.15.2 wkhtmltopdf/0.12.6），访问生成PDF的源页面，查看是否出现相同提示栏。

• 自定义User-Agent参数
  尝试将wkhtmltopdf的UA伪装成现代浏览器，绕过页面的浏览器检测。在pdfkit的配置中添加--user-agent参数，示例代码：

  import pdfkit
  config = pdfkit.configuration(wkhtmltopdf='/usr/bin/wkhtmltopdf')
  options = {
      'user-agent': 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36'
  }
  pdfkit.from_url('目标页面URL', '输出文件.pdf', configuration=config, options=options)
  

• 排查页面的浏览器检测逻辑
  查看目标页面的HTML/JS代码，搜索browser not supported等关键词，定位触发提示的逻辑。若为页面JS检测UA或内核版本，可通过wkhtmltopdf的--run-script参数注入自定义JS隐藏提示元素，示例：

  wkhtmltopdf --run-script "document.querySelector('.browser-warning').style.display='none';" 目标页面URL 输出文件.pdf
  

  需先确认提示元素的CSS选择器（如类名、ID）。

• 检查wkhtmltopdf-static版本
  执行wkhtmltopdf --version查看当前版本，若版本较旧（如0.12.x早期版本），其WebKit内核可能被网站判定为过时浏览器。尝试更新AUR中的wkhtmltopdf-static包至最新版本。

• 排查网络中间件注入
  使用curl直接请求目标页面（命令：curl 目标页面URL），查看返回内容是否包含提示栏代码。若存在，说明是代理、VPN或本地安全软件等中间件注入的提示，需排查网络环境。

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