背景
- wkhtmltopdf这个库友好地支持将html文件转换为pdf文件，它基于QT的webkit进行渲染，因此依赖于操作系统的图形用户界面操作。
- 而服务器一般是运行级别3（即多用户状态下的字符终端界面），因此在服务器端直接调用wkhtmltopdf会报如下错误：
qt.qpa.screen: QXcbConnection: Could not connet to display
Cloud not connect to any X display
- 原因就在于wkhtmltopdf依赖于X server (linux 操作系统里面图形接口服务器的简称)，而一般服务器运行在字符终端级别，并没有启动图形用户界面 ，因此产生无法连接到X display服务的错误。
解决方案
在 xvfb（X virtual framebuffer）中运行wkhtmltopdf， xvfb能够直接处理图形化功能，给应用程序提供一个虚拟的X server。
ubuntu 下使用包管理工具直接安装
sudo apt-get install xvfb
- 在xvfb中运行wkhtmltopdf
xvfb-run wkhtmltopdf $source $destination
- 通过这种方式即可解决wkhtmltopdf产生的"Cloud not connect to any X display"的错误。
参考代码
- 以下提供golang版本的示例代码
- 该代码将htmlFile(绝对路径)这个html文件转换为pdfFile(绝对路径)pdf文件
func generatePdfFile(htmlFile string, pdfFile string)error{
// xvbf命令
xvfbCommand, err := exec.LookPath("xvfb-run")
if err != nil{
return errors.New("xvfb未安装")
}
// wkhtmltopdf命令
wkh2fCommand, err := exec.LookPath("wkhtmltopdf")
if err != nil{
return errors.New("wkhtmltopdf未安装")
}
args := []string{wkh2fCommand, htmlFile, pdfFile}
errBuf := &bytes.Buffer{}
cmd := exec.Command(xvfbCommand, args...)
cmd.Stderr = errBuf
err = cmd.Run()
if err != nil{
errStr := errBuf.String()
if strings.TrimSpace(errStr) == ""{
errStr = err.Error()
}
return errors.New(errStr)
}
return nil
}
- 另，关于操作系统的7个运行级别如下
关于操作系统的7个运行级别
运行级别0：系统停机状态，系统默认运行级别不能设为0，否则不能正常启动
运行级别1：单用户工作状态，root权限，用于系统维护，禁止远程登陆
运行级别2：多用户状态(没有NFS)
运行级别3：完全的多用户状态(有NFS)，登陆后进入控制台命令行模式
运行级别4：系统未使用，保留
运行级别5：X11控制台，登陆后进入图形GUI模式
运行级别6：系统正常关闭并重启，默认运行级别不能设为6，否则不能正常启动
