使用 IronPDF 在本地调试 Azure Functions

Curtis Chau

Updated: 2026年4月24日

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # 使用 IronPDF 在本地调试 Azure Functions ## 本地运行Azure时的问题 遇到此问题时常见的异常是"定位部署配置文件IronPdf.Native.Chrome.deployment.json时出错。" **推荐**：运行目标是.NET Core 3.1 `<TargetFramework>netcoreapp3.1</TargetFramework>`的Windows托管Azure Function Apps **必需：** 在 Visual Studio 中创建 Azure 函数时使用默认的 **"在进程中"** 配置。 IronPDF 的最新版本支持运行在 "出进程" 或 "隔离进程" 中的 Azure Functions，可以参阅 "[在隔离工作模型中运行 C# Azure Functions的指南](https://docs.microsoft.com/en-us/azure/azure-functions/dotnet-isolated-process-guide#differences-with-net-class-library-functions)"。但是，旧版本可能不支持这些类型的Azure Functions。  ## 本地运行Azure Functions时的依赖问题 在本地使用 Azurite (VS2022) 或 Azure Storage Emulator (VS2019) 运行 Azure 时，会创建一个额外的 bin 目录，存储模拟器用于部署。 只有 DLL 文件被复制到此目录，因此需要额外文件的软件将无法运行，并可能抛出上述异常。 您可以通过将 runtimes 目录复制到存储模拟器使用的单独 bin 目录中来解决此问题。 我们建议在本地运行时作为 **构建后事件**（见下方说明）执行此操作（因为重新编译/构建将使 bin 目录恢复到其原始状态）。 部署到云端时，你将不会遇到此问题。 - **问题：** 本地运行 Azure 函数项目时，它会创建一个额外的 _bin_ 文件夹，并在其外运行函数。 然而，它并没有将所有必要的文件复制到该 _bin_ 文件夹中。 - **例子：** 一个项目位于 _C:\code\azure-functions-test_，构建到 _C:\code\azure-functions-test\bin\Debug\netcoreapp3.1_ - **解决方案：** 复制 _C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\runtimes_ 目录，使其也存在于 _C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\bin_ - 如果提示，覆盖任何现有文件  ## 构建后事件 要自动将必要的文件复制到本地 Azure Functions bin 目录，请按照以下说明在 Visual Studio 中设置 *构建后事件*： 1. 右键单击 Azure Functions 项目，选择 **属性**。 2. 向下滚动到 **事件** 部分。 3. 输入下面显示的 **构建后事件**： ```shell XCOPY "$(TargetDir)runtimes" "$(TargetDir)bin\runtimes" /S /E /Y /I /R /D ``` 此命令将： - 将 _runtimes_ 目录的内容复制到 _bin/runtimes_ 目录。 - `/E`开关确保包括所有子目录和空目录。 - `/Y`开关抑制提示，以确认您要覆盖现有目标文件。 - `/I`开关假定目标是一个目录，如果它不存在。 - `/R`开关覆盖只读文件。 - `/D`开关复制指定日期或之后更改的文件。 

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

本地运行Azure时的问题

遇到此问题时常见的异常是"定位部署配置文件IronPdf.Native.Chrome.deployment.json时出错。"

推荐：运行目标是.NET Core 3.1 <TargetFramework>netcoreapp3.1</TargetFramework>的Windows托管Azure Function Apps

必需： 在 Visual Studio 中创建 Azure 函数时使用默认的 "在进程中" 配置。 IronPDF 的最新版本支持运行在 "出进程" 或 "隔离进程" 中的 Azure Functions，可以参阅 "在隔离工作模型中运行 C# Azure Functions的指南"。但是，旧版本可能不支持这些类型的Azure Functions。

本地运行Azure Functions时的依赖问题

在本地使用 Azurite (VS2022) 或 Azure Storage Emulator (VS2019) 运行 Azure 时，会创建一个额外的 bin 目录，存储模拟器用于部署。 只有 DLL 文件被复制到此目录，因此需要额外文件的软件将无法运行，并可能抛出上述异常。

您可以通过将 runtimes 目录复制到存储模拟器使用的单独 bin 目录中来解决此问题。 我们建议在本地运行时作为 构建后事件（见下方说明）执行此操作（因为重新编译/构建将使 bin 目录恢复到其原始状态）。 部署到云端时，你将不会遇到此问题。

• 问题： 本地运行 Azure 函数项目时，它会创建一个额外的 bin 文件夹，并在其外运行函数。 然而，它并没有将所有必要的文件复制到该 bin 文件夹中。
• 例子： 一个项目位于 C:\code\azure-functions-test，构建到 C:\code\azure-functions-test\bin\Debug\netcoreapp3.1
• 解决方案： 复制 C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\runtimes 目录，使其也存在于 C:\code\azure-functions-test\bin\Debug\netcoreapp3.1\bin
• 如果提示，覆盖任何现有文件

构建后事件

要自动将必要的文件复制到本地 Azure Functions bin 目录，请按照以下说明在 Visual Studio 中设置 构建后事件：

1. 右键单击 Azure Functions 项目，选择 属性。
2. 向下滚动到 事件 部分。
3. 输入下面显示的 构建后事件：

XCOPY "$(TargetDir)runtimes" "$(TargetDir)bin\runtimes" /S /E /Y /I /R /D

XCOPY "$(TargetDir)runtimes" "$(TargetDir)bin\runtimes" /S /E /Y /I /R /D

此命令将：

• 将 runtimes 目录的内容复制到 bin/runtimes 目录。
• /E开关确保包括所有子目录和空目录。
• /Y开关抑制提示，以确认您要覆盖现有目标文件。
• /I开关假定目标是一个目录，如果它不存在。
• /R开关覆盖只读文件。
• /D开关复制指定日期或之后更改的文件。

Curtis Chau

立即与工程团队聊天

技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

...

阅读更多