CentOS 7下Odoo 14打印发票时wkhtmltopdf报错求助

问题描述 #

在CentOS 7系统的Odoo 14中打印发票时，弹出警告：

Your installation of Wkhtmltopdf seems to be broken. The report will be shown in html.
（翻译：你的Wkhtmltopdf安装已损坏，报表将以HTML格式显示）

已按相关教程安装但问题依旧，以下是针对性的排查与修复步骤：

1. 校验版本兼容性 #

Odoo 14仅兼容wkhtmltopdf 0.12.5（带patched Qt版本），先检查当前安装版本：

wkhtmltopdf --version

若版本不符，先卸载现有版本：

yum remove -y wkhtmltopdf

2. 重新安装兼容版本 #

针对CentOS 7 64位系统，执行以下命令：

# 下载官方适配版本
wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.5-1/wkhtmltox-0.12.5-1.centos7.x86_64.rpm
# 安装依赖库
yum install -y libXrender libXext fontconfig
# 安装wkhtmltopdf
rpm -ivh wkhtmltox-0.12.5-1.centos7.x86_64.rpm
# 创建系统路径软链接，确保Odoo能找到
ln -s /usr/local/bin/wkhtmltopdf /usr/bin/wkhtmltopdf
ln -s /usr/local/bin/wkhtmltoimage /usr/bin/wkhtmltoimage

3. 验证基础功能 #

执行测试命令，确认能正常生成PDF：

wkhtmltopdf https://www.odoo.com /tmp/test_odoo.pdf

若/tmp/test_odoo.pdf生成成功，说明安装无问题。

4. 配置Odoo路径 #

打开Odoo配置文件（通常为/etc/odoo.conf），添加或修改wkhtmltopdf路径配置：

[options]
# 其他配置...
wkhtmltopdf = /usr/bin/wkhtmltopdf

保存后重启Odoo服务：

systemctl restart odoo

5. 修复字体缺失（解决中文乱码/渲染异常） #

若打印中文报表出现乱码，安装中文字体：

yum install -y wqy-microhei-fonts
# 更新字体缓存
fc-cache -fv

6. 检查权限设置 #

确保Odoo运行用户（默认odoo）拥有wkhtmltopdf的执行权限：

chmod +x /usr/bin/wkhtmltopdf
chown odoo:odoo /usr/bin/wkhtmltopdf

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