远程VPS服务器用Xvfb运行X Server失败，wkhtmltopdf依赖遇阻求助

我之前也踩过wkhtmltopdf+Xvfb的坑，光装Xvfb确实不一定能解决问题，咱们一步步排查：

1. 确认Xvfb的启动与环境变量配置 #

有时候手动启动Xvfb后，DISPLAY环境变量没正确关联，导致wkhtmltopdf找不到虚拟X服务。试试这套操作：

• 先启动后台Xvfb进程：

  Xvfb :1 -screen 0 1024x768x16 &
  

• 临时设置DISPLAY指向这个虚拟显示：

  export DISPLAY=:1
  

• 再重新运行你的wkhtmltopdf命令，看是否能正常工作。

2. 补全wkhtmltopdf的X11依赖库 #

wkhtmltopdf除了需要Xvfb，本身还依赖一些X11基础库，这些库缺失会导致隐性报错。执行以下命令安装必备依赖：

sudo pacman -S libxrender libxext libxtst

3. 用封装脚本规避环境变量问题 #

手动设置环境变量容易遗漏，写个简单的脚本自动处理所有步骤更靠谱：
创建wkhtmltopdf-wrapper.sh文件，内容如下：

#!/bin/bash
# 启动虚拟X服务，输出重定向避免干扰
Xvfb :99 -screen 0 1024x768x16 > /dev/null 2>&1 &
# 绑定DISPLAY到虚拟服务
export DISPLAY=:99
# 调用wkhtmltopdf并传递所有参数
wkhtmltopdf "$@"
# 用完关闭Xvfb进程
kill %1

给脚本加执行权限：

chmod +x wkhtmltopdf-wrapper.sh

之后用这个脚本代替直接调用wkhtmltopdf，比如：

./wkhtmltopdf-wrapper.sh 你的输入文件.html 输出文件.pdf

4. 更新wkhtmltopdf到最新版本 #

旧版本的wkhtmltopdf可能存在与新版Xvfb的兼容性问题，执行系统更新命令升级：

sudo pacman -Syu wkhtmltopdf

5. 查看完整错误日志针对性解决 #

如果以上方法都无效，一定要看完整的错误输出，执行：

wkhtmltopdf 你的输入文件.html 输出文件.pdf 2>&1

比如：

• 如果提示字体缺失，安装基础字体包：sudo pacman -S ttf-dejavu ttf-liberation
• 如果提示X连接失败，用ps aux | grep Xvfb检查Xvfb是否真的在运行

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