如何在集成测试中通过依赖注入实例化Azure函数？

问题背景 #

给定以下Azure Functions类：

public class CheckApplications(IGovernanceService governanceService, ILogger<CheckApplications> logger)
{
    [Function(nameof(CheckApplications))]
    public async Task CheckApplicationsTimerTrigger(
        [TimerTrigger("0 0 12 * * *", RunOnStartup = false)] TimerInfo myTimer,
        FunctionContext context,
        CancellationToken cancellationToken)
    {
        ...
    }
}

由于没有适用于Azure Functions的Microsoft.AspNetCore.Mvc.Testing包，希望通过代码实例化函数进行集成测试，但发现服务集合中不存在单独的函数实例，该如何处理？

解决方案 #

Azure Functions类本身是通过依赖注入构造的，测试时可以直接手动注入依赖实例来创建函数对象，无需依赖完整的Functions运行时服务容器。具体步骤如下：

1. 准备依赖的测试/模拟实现 #

针对函数类构造函数中的依赖（如IGovernanceService），可以使用模拟框架（如Moq）创建模拟对象，或者编写测试专用的实现类；对于ILogger，可以使用NullLogger或测试日志工厂创建实例。

2. 直接实例化函数类 #

通过手动传入依赖实例，直接构造CheckApplications对象，然后调用目标方法并验证行为。

示例代码（xUnit + Moq） #

using Xunit;
using Moq;
using Microsoft.Extensions.Logging;
using Microsoft.Azure.Functions.Worker;
using System.Threading;

public class CheckApplicationsTests
{
    [Fact]
    public async Task CheckApplicationsTimerTrigger_ExecutesBusinessLogic()
    {
        // 模拟业务服务
        var mockGovernanceService = new Mock<IGovernanceService>();
        // 配置mock的预期行为，例如验证特定方法是否被调用
        mockGovernanceService.Setup(s => s.ProcessApplications(It.IsAny<CancellationToken>()))
                             .ReturnsAsync(true);

        // 创建测试用Logger
        var logger = NullLogger<CheckApplications>.Instance;
        // 或者使用带控制台输出的Logger：
        // var logger = LoggerFactory.Create(b => b.AddConsole()).CreateLogger<CheckApplications>();

        // 实例化函数类
        var functionInstance = new CheckApplications(mockGovernanceService.Object, logger);

        // 准备方法参数
        var timerInfo = new TimerInfo(new TimerScheduleStatus(), new TimerOptions());
        var mockContext = new Mock<FunctionContext>().Object;
        // 若需验证Context中的服务，可以进一步配置：
        // var testServices = new ServiceCollection().AddSingleton(...).BuildServiceProvider();
        // mockContext.Setup(c => c.InstanceServices).Returns(testServices);

        var cancellationToken = CancellationToken.None;

        // 调用目标方法
        await functionInstance.CheckApplicationsTimerTrigger(timerInfo, mockContext, cancellationToken);

        // 验证mock服务的方法是否按预期执行
        mockGovernanceService.Verify(s => s.ProcessApplications(cancellationToken), Times.Once);
    }
}

补充说明 #

• 如果函数方法依赖FunctionContext的更多属性（如绑定数据、运行时配置），可以通过Mock<FunctionContext>进一步模拟所需成员。
• 若需要更贴近真实运行环境的测试，可以使用Microsoft.Azure.Functions.Worker.Testing包提供的测试工具，但手动实例化的方式更轻量，适合快速验证业务逻辑。

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