当前位置：首页 > news >正文

C# Wkhtmltopdf HTML转PDF碰到的问题

news 来源：原创 2025/6/6 17:38:57

最近碰到一个Html转PDF的需求，看了一下基本上都是需要依赖Wkhtmltopdf，需要在Windows或者linux安装这个可以后使用。找了一下选择了HtmlToPDFCore，这个库是对Wkhtmltopdf.NetCore简单二次封装，这个库的好处就是通过NuGet安装HtmlToPDFCore就带了Windows/Mac/Linux的依赖包，就是包有点大。HtmlToPDFCore包含了Wkhtmltopdf.NetCore，直接用Wkhtmltopdf.NetCore也是可以的。

下面总结一下碰到的问题：

1、权限问题

An error occurred trying to start process '/path/rotativa/Linux/wkhtmltopdf' with working directory '/path'. Permission denied

本质上Wkhtmltopdf.NetCore是通过进程调用Wkhtmltopdf的，在Linux会有执行权限问题，需要给到wkhtmltopdf执行权限

2、中文乱码的问题

中文在Windows是正常的，但是Linux有问题

# 安装中文字体包
sudo apt-get update
sudo apt-get install -y \fonts-wqy-microhei \fonts-wqy-zenhei \fonts-noto-cjk \ttf-mscorefonts-installer \fontconfig# 刷新字体缓存
sudo fc-cache -fv# 验证中文字体安装
fc-list :lang=zh

3、直接通过wkhtmltopdf检查是否可以正常使用

wkhtmltopdf是可以直接调用的

如果输出的pdf是正常的，那么在代码里调用也是正常的

接下来就可以正常使用了：

HtmlToPDFCore.HtmlToPDF htmlToPDF   = new HtmlToPDFCore.HtmlToPDF();var html ="<html><body>123中文</body></html>";return File(htmlToPDF.ReturnPDF(html), "application/pdf", $"{id}_{DateTime.Now:yyyyMMddHHmmss}.pdf");

HtmlToPDFCore项目地址：GitHub - carloscds/HtmlToPDFCore: Convert HTML to PDF