如何为Azure Function App添加启动过滤器以在DI与触发器启动间执行操作

Azure Function App的启动生命周期和ASP.NET Core Web App不同，原生不支持IStartupFilter，但可以通过扩展IFunctionsStartup来实现启动阶段的配置验证逻辑，完全适配遗留项目的DI流程。

核心实现思路 #

借助IFunctionsStartup（Function App的DI扩展入口），在配置绑定完成后，手动触发配置验证逻辑。验证失败时抛出异常终止宿主启动，让部署监控通过启动状态感知并跳过环境切换。

具体步骤与代码示例 #

1. 定义配置验证服务 #

复用遗留项目中已绑定的配置类，编写验证逻辑：

public interface IConfigValidator
{
    void Validate();
}

public class AppConfigValidator : IConfigValidator
{
    private readonly LegacyAppConfig _legacyConfig;

    // 注入遗留项目中已通过DI绑定的配置类
    public AppConfigValidator(LegacyAppConfig legacyConfig)
    {
        _legacyConfig = legacyConfig;
    }

    public void Validate()
    {
        // 编写具体验证规则，覆盖所有业务要求的校验项
        if (string.IsNullOrWhiteSpace(_legacyConfig.CoreApiUrl))
        {
            throw new InvalidOperationException("配置验证失败：CoreApiUrl 为必填项");
        }

        if (_legacyConfig.TimeoutSeconds <= 0 || _legacyConfig.TimeoutSeconds > 300)
        {
            throw new InvalidOperationException("配置验证失败：TimeoutSeconds 必须在1-300之间");
        }

        // 其他验证规则...
    }
}

2. 扩展IFunctionsStartup执行启动验证 #

在Function App的启动类中，保留原有DI配置逻辑，新增验证服务注册并手动触发验证：

[assembly: FunctionsStartup(typeof(YourFunctionAppNamespace.Startup))]
namespace YourFunctionAppNamespace
{
    public class Startup : FunctionsStartup
    {
        public override void Configure(IFunctionsHostBuilder builder)
        {
            // 保留遗留项目原有的DI配置：绑定App Config到配置类
            var config = builder.GetContext().Configuration;
            builder.Services.Configure<LegacyAppConfig>(config.GetSection("LegacyAppSettings"));
            // 其他原有DI注册逻辑...

            // 注册配置验证服务
            builder.Services.AddSingleton<IConfigValidator, AppConfigValidator>();

            // 构建临时服务提供者，执行启动验证
            using var serviceProvider = builder.Services.BuildServiceProvider();
            var validator = serviceProvider.GetRequiredService<IConfigValidator>();
            try
            {
                validator.Validate();
            }
            catch (Exception ex)
            {
                // 验证失败时抛出异常，终止Function宿主启动
                throw new InvalidOperationException("启动阶段配置验证未通过，函数应用终止启动", ex);
            }
        }
    }
}

3. 部署监控适配 #

验证失败时，Function App宿主会启动失败：

• 监控系统可通过Azure Function的健康状态API（/admin/host/status）检查healthy字段，若为false则跳过生产/Staging环境切换
• 异常信息会写入Function App日志（Application Insights或Kudu日志），便于排查配置问题

关键说明 #

• 为何不用IStartupFilter：Azure Function宿主未集成ASP.NET Core的IStartupFilter管道，直接注册不会触发执行
• 最小改动：完全复用遗留项目的配置绑定与DI流程，仅新增验证服务与启动阶段的触发逻辑，无需修改原有业务代码

内容的提问来源于stack exchange，提问作者N Sin