如何在Ubuntu 22.04上安装并运行wkhtmltopdf（解决平台报错）

出现这个错误是因为你用的安装工具（比如旧版gem或自动化脚本）只支持到Ubuntu 20.04，没法识别22.04系统。下面是几种可行的解决办法：

方法一：安装官方预编译的兼容二进制包 #

这是最简单的方案：

• 去wkhtmltopdf官方打包仓库，下载适配Ubuntu 22.04（Jammy Jellyfish）的amd64架构deb包
• 安装必要依赖：

  sudo apt-get install libssl3 libxrender1 libxext6 libfontconfig1 libjpeg-turbo8 libpng16-16 libxcb1 libx11-6
  

• 安装下载的包：

  sudo dpkg -i 下载的deb包文件名.deb
  

• 验证是否安装成功：

  wkhtmltopdf --version
  

方法二：配置Rails项目指定二进制路径 #

如果是通过wicked_pdf这类Ruby gem调用wkhtmltopdf，需要确保gem能找到正确的二进制文件：

• 在项目的config/initializers/wicked_pdf.rb文件里添加配置（如果文件不存在就新建一个）：

  WickedPdf.config = {
    exe_path: '/usr/local/bin/wkhtmltopdf'
  }
  

• 重启Rails服务器，测试PDF生成功能。

方法三：源码编译安装（预编译包失效时用） #

如果预编译包没法正常工作，可以手动编译源码：

• 安装编译依赖：

  sudo apt-get install build-essential libssl-dev libxrender-dev libxext-dev libfontconfig-dev libjpeg-dev libpng-dev libxcb-dev libx11-dev git
  

• 克隆源码并切换到稳定版本：

  git clone https://github.com/wkhtmltopdf/wkhtmltopdf.git
  cd wkhtmltopdf
  git checkout 0.12.6.1
  

• 编译并安装：

  mkdir build
  cd build
  cmake ..
  make -j$(nproc)
  sudo make install
  

• 验证安装：

  wkhtmltopdf --version
  

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