Azure Function（Linux环境）下用C#借助IronPdf实现HTML转PDF：权限与依赖问题

我之前刚好碰到过一模一样的问题！折腾了好一阵才搞定，给你分享几个亲测有效的关键步骤，都是针对IronPdf在Linux Azure Function环境下的适配：

1. 强制指定IronPdf使用有权限的临时目录 #

Linux Azure Function的默认临时目录/tmp是有读写权限的，但IronPdf默认可能会尝试使用其他受限制的路径。你需要在代码初始化IronPdf时手动指定临时文件夹：

using IronPdf;

public class PdfConversionFunction
{
    public void Run()
    {
        // 初始化前先设置临时目录
        IronPdf.Installation.TempFolderPath = "/tmp";
        // 后续正常使用IronPdf的代码
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>HTML转PDF测试</h1>");
        // ... 后续处理逻辑
    }
}

这一步能解决大部分“权限被拒绝”的错误。

2. 补全Linux系统依赖库 #

IronPdf依赖几个Linux系统级库，Azure Function的基础镜像里默认没装这些。你可以通过两种方式解决：

• 方式一：使用自定义部署脚本
  在你的Function项目根目录创建一个deploy.sh脚本，内容如下：

  #!/bin/bash
  apt-get update && apt-get install -y libgdiplus libc6-dev libx11-dev libfontconfig1
  

  然后在Azure Function的配置里，把“启动命令”设置为./deploy.sh && dotnet YourFunctionApp.dll（替换成你的Function DLL名称）。

• 方式二：使用自定义容器镜像
  如果你的Function用的是容器计划，可以在Dockerfile里添加安装依赖的命令：

  FROM mcr.microsoft.com/azure-functions/dotnet:4
  RUN apt-get update && apt-get install -y libgdiplus libc6-dev libx11-dev libfontconfig1
  # 后续的镜像构建步骤...
  

3. 确保NuGet依赖完整部署 #

有时候部署时IronPdf的原生二进制文件会丢失，你需要在项目的.csproj文件里添加以下配置，确保所有依赖都被复制到输出目录：

<PropertyGroup>
  <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
</PropertyGroup>

这样部署时，IronPdf的Linux原生库会被正确放到/home/site/wwwroot/bin/runtimes/linux-x64/native/路径下。

4. 设置环境变量让系统找到原生库 #

在Azure Function的“配置”→“应用程序设置”里添加一个环境变量：

• 名称：LD_LIBRARY_PATH
• 值：/home/site/wwwroot/bin/runtimes/linux-x64/native/
  这能确保Linux系统加载IronPdf需要的原生库文件。

按照这几步操作后，我当时的问题就完全解决了，你可以逐个试一遍，重点先检查临时目录和系统依赖这两项，大部分情况下这两个是核心问题。

备注：内容来源于stack exchange，提问作者Mehr Muhammad Hamza