如何让面向.NET 8的源生成Azure Functions正常工作？

问题根源 #

.NET 8 的 Azure Functions SDK 改用 DirectFunctionExecutor 和 GeneratedFunctionMetadataProvider 这两个自动生成的类来管理函数元数据与执行逻辑，不再依赖旧的反射机制。但自定义源生成器产出的函数类未被这两个类纳入函数列表，导致Azure宿主无法识别这些函数。

修复方案 #

1. 对齐自定义源生成器的输出格式 #

自定义源生成器生成的函数代码必须符合.NET 8 Functions SDK的要求：

• 函数类必须标记 [FunctionName("你的函数名")] 特性，触发器要正确标记 [EventGridTrigger]
• 函数方法签名要合规，示例：

public static void Run([EventGridTrigger] EventGridEvent eventGridEvent, ILogger log)
{
    // 函数逻辑
}

• 参考官方源生成器的输出结构，确保生成的元数据类能被SDK的自动扫描机制识别。

2. 手动注册函数元数据 #

如果自定义生成器无法自动适配SDK的扫描逻辑，可以手动注册元数据：

• 新建静态类实现 IFunctionMetadataProvider，返回自定义函数的元数据：

using Microsoft.Azure.Functions.Worker;
using Microsoft.Azure.Functions.Worker.Metadata;

public class CustomFuncMetadataProvider : IFunctionMetadataProvider
{
    public IEnumerable<FunctionMetadata> GetFunctionMetadata()
    {
        yield return new FunctionMetadata
        {
            Name = "你的生成函数名",
            TriggerType = "EventGridTrigger",
            InputBindings = new List<BindingMetadata>
            {
                new BindingMetadata
                {
                    Type = "eventGridTrigger",
                    Name = "eventGridEvent"
                }
            },
            // 补充其他必填元数据，比如输出绑定、返回类型等
        };
        // 多个生成函数可继续yield return
    }
}

• 在 Program.cs 中注册这个自定义提供者：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureServices(services =>
    {
        services.AddSingleton<IFunctionMetadataProvider, CustomFuncMetadataProvider>();
    })
    .Build();

host.Run();

3. 验证与排查 #

• 用dotPeek检查编译后的dll，确认自定义函数的元数据要么被 GeneratedFunctionMetadataProvider 包含，要么自定义的提供者类被正确嵌入。
• 本地运行函数，查看控制台日志，确认函数是否被加载；若本地可识别但Azure不行，检查部署包是否包含所有生成的dll文件。
• 到Azure门户的函数应用“监控”->“日志”中查看错误信息，排查元数据加载失败的具体原因。

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