使用Select.HtmlToPdf.NetCore在Azure函数转HTML字符串报错排查

可能的原因及修复步骤 #

• 确保HTML字符串完整合法
  传入的html必须是完整的HTML文档结构，包含<html>、<head>、<body>标签。仅传入片段会导致解析异常，示例如下：

  // 错误：仅HTML片段
  string html = "<p>测试文本</p>";
  // 正确：完整HTML文档
  string html = "<!DOCTYPE html><html><head></head><body><p>测试文本</p></body></html>";
  

• 提升Visual Studio运行权限
  SelectPdf转换依赖内部浏览器引擎，本地运行Azure函数时，若当前用户权限受限，可能无法加载内部资源。尝试以管理员身份启动Visual Studio后重新测试。

• 匹配SelectPdf与Azure函数运行时版本
  确认SelectPdf v23.2.0是否兼容你使用的Azure函数运行时（如.NET 6/.NET 7）。版本不匹配可能引发兼容性问题，可尝试升级或降级SelectPdf版本适配运行时。

• 禁用浏览器沙箱模式
  部分环境下，浏览器沙箱会阻止资源加载，可通过代码禁用沙箱：

  HtmlToPdf converter = new HtmlToPdf();
  converter.Options.WebKitDisableSandbox = true;
  PdfDocument doc = converter.ConvertHtmlString(html);
  

• 清理HTML中的外部资源引用
  即便未传入基础URL，若HTML包含相对路径的外部资源（如<img>、<link>），转换时会尝试解析这些资源，无法找到就会报错。可移除外部引用，或转为内联资源（如base64格式图片）。

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