.NET 8独立进程Function App无法加载依赖项目中的函数

问题背景 #

我有一个包含两个Azure Functions项目的解决方案，配置如下：

• 两个项目均为Targetframework: net8.0、AzureFunctionsVersion: v4，启用<FunctionsInDependencies>true</FunctionsInDependencies>，采用独立进程（isolated）模型
• 主项目FunctionApp2自身无实际函数（Function2.cs仅含注释代码），目的是启动依赖项目FunctionAppNet8中的函数
• 当前问题：必须在主项目中实现并启动一个函数后，依赖中的函数才会加载；即便在Program.cs实例化依赖项目的虚拟类建立主动依赖，也没有效果
• 对比：.NET 6进程内模型通过Startup.cs类继承建立主动依赖，可正常加载依赖中的函数

已尝试的方案 #

• 添加主动依赖（实例化依赖项目虚拟类）：无效，除非主项目有自己的函数
• 将依赖项目的作业文件作为链接添加到主项目：可行，但属于临时方案

正确解决方案（基于true配置） #

1. 修正主项目Program.cs的依赖加载逻辑 #

独立进程模型下，仅实例化虚拟类可能无法触发依赖程序集的完整加载，需要显式引用依赖项目中的函数类型，确保程序集被运行时扫描到。修改FunctionApp2的Program.cs：

using Microsoft.Extensions.Hosting;
using FunctionAppNet8; // 引入依赖项目的命名空间

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .Build();

// 显式引用依赖项目中的函数类，强制加载对应程序集
_ = typeof(Function1); // 替换为你依赖项目中实际的函数类名

host.Run();

2. 验证项目配置与引用 #

• 确保主项目FunctionApp2对FunctionAppNet8有项目级引用（不是仅文件引用或NuGet包）
• 确认两个项目的.csproj配置一致：

  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
    <FunctionsInDependencies>true</FunctionsInDependencies>
    <OutputType>Exe</OutputType>
    <IsPackable>false</IsPackable>
  </PropertyGroup>
  

3. 清理重建解决方案 #

删除两个项目的bin和obj目录，清理NuGet缓存后重新构建，避免编译缓存导致的配置不生效问题。

原理说明 #

.NET 8独立进程模型的Functions运行时扫描逻辑和进程内模型不同：进程内模型通过Startup的继承关系可自动触发依赖程序集扫描，而独立进程模型需要依赖程序集被加载到当前AppDomain中，才能被函数扫描机制检测到。显式引用依赖项目的函数类型，会强制运行时加载该程序集，配合<FunctionsInDependencies>true配置，就能让运行时识别并加载依赖项目中的函数。

内容的提问来源于stack exchange，提问作者Gergely Glász