Bitnami打包的Odoo 15无法识别Wkhtmltopdf扩展报错求助

Odoo生成PDF格式的业务报告（如销售订单、采购单、财务发票等）时，依赖Wkhtmltopdf组件完成HTML到PDF的转换。你使用的Bitnami打包的Odoo 15虚拟机镜像默认未预装该组件，或是Odoo配置中未正确指向Wkhtmltopdf的执行路径，因此触发该报错。
报错原始提示如下：

Report 
Unable to find Wkhtmltopdf on this system. 
The report will be shown in html.

步骤1：进入Odoo虚拟机终端 #

启动VMware中的Bitnami Odoo 15虚拟机，使用默认账号bitnami登录系统，密码为你首次启动虚拟机时设置的自定义密码。

步骤2：安装匹配版本的Wkhtmltopdf #

Odoo 15仅适配Wkhtmltopdf 0.12.5/0.12.6版本，请勿使用更高版本，避免出现排版异常。

• 先更新系统源并安装依赖：

sudo apt update
sudo apt install fontconfig libxrender1 libjpeg-turbo8 libxext6 xfonts-75dpi xfonts-base

• 下载对应你虚拟机系统架构和版本的Wkhtmltopdf 0.12.6安装包后，执行安装命令：

sudo dpkg -i <你下载的安装包文件名.deb>

• 若安装过程提示依赖缺失，执行以下命令修复后重新安装即可：

sudo apt --fix-broken install

步骤3：验证安装并记录执行路径 #

执行以下命令验证安装是否成功：

wkhtmltopdf --version

若终端正常输出版本号则代表安装成功，接着执行以下命令获取执行路径，记录后续配置使用：

which wkhtmltopdf

通常默认输出路径为/usr/bin/wkhtmltopdf或/usr/local/bin/wkhtmltopdf。

步骤4：配置Odoo的Wkhtmltopdf路径 #

两种配置方式二选一即可：

方式A：网页后台配置 #

1. 用管理员账号登录Odoo网页端，进入设置页面，下拉到页面底部的开发者工具区域，点击激活开发者模式，刷新页面
2. 重新进入设置，依次选择技术 -> 参数 -> 系统参数
3. 新建系统参数，键填web.base.url.freeze，值填True，保存
4. 查找是否存在wkhtmltopdf_path参数，不存在则新建，键填wkhtmltopdf_path，值填步骤3中记录的Wkhtmltopdf绝对路径，保存

方式B：修改配置文件 #

Bitnami Odoo的默认配置文件路径为/opt/bitnami/odoo/config/odoo.conf，用编辑器打开该文件：

sudo nano /opt/bitnami/odoo/config/odoo.conf

在配置文件中新增一行，填入你记录的路径：

wkhtmltopdf = /usr/bin/wkhtmltopdf

保存退出编辑器。

步骤5：重启Odoo服务生效 #

执行Bitnami自带的服务管理命令重启Odoo：

sudo /opt/bitnami/ctlscript.sh restart odoo

重启完成后重新访问Odoo网页端，测试生成PDF报告即可恢复正常。

• 若生成的PDF出现中文乱码，可在虚拟机中安装中文字体包解决：

sudo apt install fonts-wqy-microhei fonts-wqy-zenhei

• 请勿使用0.12.7及以上版本的Wkhtmltopdf，Odoo 15对高版本适配存在兼容问题，可能出现页眉页脚丢失、排版错乱的情况

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