Ubuntu18.04下Odoo12中Wkhtmltopdf报错及安装卸载问题求助

我之前也踩过这个坑，错误代码-8大多和wkhtmltopdf版本不兼容或者依赖缺失有关，卸载不掉通常是因为安装方式混杂留下了残留。下面一步步帮你搞定：

第一步：彻底卸载现有wkhtmltopdf #

根据你的安装方式选对应的命令：

• 如果是通过apt安装的：

  sudo apt remove --purge wkhtmltopdf
  sudo apt autoremove && sudo apt clean
  

• 如果是手动下载deb包安装的：

  # 先移除主包
  sudo dpkg -r wkhtmltopdf
  # 彻底清理残留配置和文件
  sudo dpkg -P wkhtmltopdf
  # 修复可能的依赖问题
  sudo apt -f install
  

要是卸载时提示“找不到包”，大概率是源码编译安装的，直接删除执行文件就行：

sudo rm -f /usr/local/bin/wkhtmltopdf

第二步：安装Odoo 12兼容的wkhtmltopdf版本 #

Odoo 12对wkhtmltopdf版本要求很严，必须用0.12.5版本且带patched Qt的包，普通版本会频繁出现渲染错误或代码-8。

1. 先装必要的依赖库：

   sudo apt install libxrender1 libfontconfig1 libxext6 libjpeg-turbo8
   

2. 下载适配Ubuntu 18.04（bionic）的对应架构deb包（比如amd64版本），然后安装：

   # 替换为你下载的包名，以amd64为例
   sudo dpkg -i wkhtmltox_0.12.5-1.bionic_amd64.deb
   # 出现依赖错误就执行这条修复
   sudo apt -f install
   

3. 验证安装成功：

   wkhtmltopdf --version
   

   正常会输出wkhtmltopdf 0.12.5 (with patched qt)这类信息。

第三步：配置Odoo并测试 #

1. 打开Odoo配置文件（一般在/etc/odoo/odoo.conf），添加或修改wkhtmltopdf的路径：

   wkhtmltopdf = /usr/local/bin/wkhtmltopdf
   

2. 重启Odoo服务：

   sudo systemctl restart odoo
   

3. 先在命令行测试工具是否正常：

   wkhtmltopdf https://www.odoo.com test.pdf
   

   能生成test.pdf的话，再去Odoo里尝试生成报表。

额外排查点 #

要是还报错，检查这两个地方：

• 确保Odoo运行用户（通常是odoo）有执行权限：

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

• 系统字体缺失也会导致渲染失败，装常用字体包：

  sudo apt install fonts-dejavu-core fonts-liberation
  

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