ASP.NET Core 3.1使用DinkToPdf生成PDF部署报错及文件URL返回问题

1. libwkhtmltox加载报错解决方案 #

你遇到的DLL加载报错是因为DinkToPdf是对原生PDF工具wkhtmltopdf的.NET封装，依赖对应系统的原生运行库，本地开发环境有相关文件但服务器未部署就会触发该错误，修复步骤如下：

• 先根据预发布服务器的操作系统下载对应版本的原生库：Windows环境对应libwkhtmltox.dll、Linux环境对应libwkhtmltox.so、macOS环境对应libwkhtmltox.dylib
• 将原生库文件放到项目根目录，设置文件属性为「如果较新则复制」，确保发布时会同步到服务器运行目录
• 在Startup.cs的ConfigureServices方法中添加原生库加载逻辑，示例代码：

var loadContext = new CustomAssemblyLoadContext();
// 此处文件名根据服务器操作系统调整
loadContext.LoadUnmanagedLibrary(Path.Combine(Directory.GetCurrentDirectory(), "libwkhtmltox.dll"));
services.AddSingleton(typeof(IConverter), new SynchronizedConverter(new PdfTools()));

• 如果是Linux服务器，还需要提前安装依赖组件：libssl1.1、libx11-6、libxext6、libxrender1、libfontconfig1，对应CentOS等发行版替换为对应包名安装即可

2. 现有代码问题修复 #

你的代码存在两个可直接导致运行失败的问题：

• TemplateGenerator.GetDocument方法定义要求传入Customer和Policy两个参数，但控制器中调用时只传入了customer单个参数，需要补充Policy参数的查询和传入逻辑，或者修改方法定义移除不必要的Policy参数
• 路径拼接使用硬编码的\\分隔符，跨平台部署会出现异常，统一替换为Path.Combine方法处理路径拼接即可
• 可选优化：TemplateGenerator的HTML代码末尾多了一个多余的</div>闭合标签，可删除避免HTML结构异常

3. 实现返回PDF访问URL的改造方案 #

你当前代码已经配置了Out参数将PDF保存到本地，但是最终返回了文件流，不符合需求，按以下步骤改造即可：

第一步：配置静态文件访问规则 #

在Startup.cs的Configure方法中添加配置，开放PDF存储目录的HTTP访问权限：

// 保留原有默认静态文件配置
app.UseStaticFiles();
// 新增PDF目录的静态访问配置
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(Directory.GetCurrentDirectory(), "customerCertificate")),
    RequestPath = "/customer-certificate"
});

第二步：修改控制器返回逻辑 #

将原有的返回文件流逻辑替换为拼接访问URL返回JSON即可：

// 原转换逻辑保留，不需要接收返回的字节流，文件已经按Out配置写入本地
_converter.Convert(pdf);
// 拼接当前站点的文件访问URL
var fileAccessUrl = $"{Request.Scheme}://{Request.Host}/customer-certificate/{documentName}";
return Ok(new 
{
    Status = true,
    Message = "PDF生成成功",
    Data = new { FileUrl = fileAccessUrl }
});

可选优化：如果文件涉及敏感信息，不建议直接开放静态目录，可以额外新增一个带权限校验的文件下载接口，返回加密后的接口地址而非直接的静态文件地址。

内容的提问来源于stack exchange，提问作者Salvation Lloyd Stanley-Kemuel