SelectPDF HtmlToPDF调用Google WebFont在Azure中失效问题排查

我的应用是部署在Microsoft Azure App Service上的.NET 5 Web API，除自定义字体功能外其他均正常。在将HTML转换为PDF的场景中，尝试了以下方案，本地测试全部正常，但部署到Azure后失效：

1. 引入Google字体链接：
   HTML头部标签：

   <link rel="stylesheet" type="text/css" href="https://fonts.googleapis.com/css?family=Muli" />
   

   对应CSS：

   html,
   body {
       font-family: Muli;
   }
   

2. 使用@font-face加载Google Fonts的woff2文件：

   @font-face {
     font-family: 'Muli';
     src: url(https://fonts.gstatic.com/s/muli/v28/7Aulp_0qiz-aVz7u3PJLcUMYOFnOkEk40eiNxw.woff2) format('woff2');
   }
   

3. 下载TTF字体文件上传至Azure Blob存储，通过Blob链接在@font-face中引用
4. 将Converter.Options.MinPageLoadTime增加至2秒

请问还有哪些可能的解决方案？

• 检查Azure App Service出站网络限制：Azure App Service可能默认限制外部资源访问，需在Azure门户的App Service -> 网络 -> 出站流量中，确认是否允许访问fonts.googleapis.com和fonts.gstatic.com；若使用VNet集成或防火墙规则，需将这些域名加入允许列表。
• 将字体嵌入应用部署包：放弃外部依赖，把TTF/WOFF2字体文件放在Web API的wwwroot/fonts目录下，用相对路径引用：

  @font-face {
    font-family: 'Muli';
    src: url('/fonts/Muli-Regular.ttf') format('truetype');
    font-weight: normal;
    font-style: normal;
  }
  

  同时在.csproj中添加配置确保字体文件被包含在发布包：

  <Content Include="wwwroot/fonts/**/*" />
  

• 优化PDF转换工具的等待策略：如果使用PuppeteerSharp这类工具，替换MinPageLoadTime为WaitForNetworkIdle，确保字体完全加载：

  using var browser = await Puppeteer.LaunchAsync(new LaunchOptions());
  using var page = await browser.NewPageAsync();
  await page.GoToAsync(htmlUrl, new NavigationOptions
  {
      WaitUntil = new[] { WaitUntilNavigation.NetworkIdle0 }
  });
  var pdf = await page.PdfAsync();
  

• 配置Blob存储字体的MIME类型：若用Blob托管字体，需在容器静态网站设置中配置正确的MIME类型：
  • .ttf: font/ttf
  • .woff2: font/woff2
    错误的MIME类型会导致转换工具无法识别字体文件。
• 用Base64嵌入字体：将字体文件转为Base64编码，直接嵌入CSS，彻底消除外部依赖：

  @font-face {
    font-family: 'Muli';
    src: url(data:font/truetype;base64,[字体文件的Base64编码内容]) format('truetype');
  }
  

• 启用App Service用户配置文件加载：在App Service配置中添加环境变量WEBSITE_LOAD_USER_PROFILE = 1，部分PDF转换库需要系统字体目录访问权限，该配置可解决权限相关的字体加载问题。

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