如何在带BlobTrigger的Azure Function应用中配置并初始化ILogger？

你碰到的这个绑定错误，根源在于Azure Functions v1版本并不原生支持ILogger，只有v2及以上版本才支持——而你想用ILogger替代TraceWriter来做单元测试，这个选择非常合理，咱们一步步来配置搞定：

1. 确认Functions运行时版本 #

先打开项目里的host.json文件，确保指定了v2及以上的运行时版本：

{
  "version": "2.0"
}

2. 配齐必要的NuGet包 #

确保你的项目引用了以下NuGet包（建议用最新稳定版）：

• Microsoft.Azure.WebJobs
• Microsoft.Azure.WebJobs.Extensions.Storage（BlobTrigger功能必须）
• Microsoft.Extensions.Logging

3. 配置Startup类（可选但推荐，支持自定义日志） #

如果需要给日志加额外的输出渠道（比如控制台、Application Insights），可以创建一个Startup类来注册服务：

using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;

[assembly: WebJobsStartup(typeof(sampleapplication.Startup))]
namespace sampleapplication
{
    public class Startup : IWebJobsStartup
    {
        public void Configure(IWebJobsBuilder builder)
        {
            // 这里可以添加自定义日志提供程序，比如控制台日志
            builder.Services.AddLogging(loggingBuilder =>
            {
                loggingBuilder.AddConsole();
                // 如果需要接入Application Insights，取消下面注释即可
                // loggingBuilder.AddApplicationInsights();
            });
        }
    }
}

4. 修正你的Function代码 #

你的现有代码其实已经接近正确了，只需要把Connection参数填对——它对应你存储账户连接字符串的配置项名称：

using System.IO;
using Microsoft.Azure.WebJobs;
using Microsoft.Extensions.Logging;

namespace sampleapplication
{
    public static class Function1
    {
        [FunctionName("Function1")]
        public static void Run(
            [BlobTrigger("testcontainer/{name}", Connection = "AzureWebJobsStorage")] Stream myBlob, 
            string name, 
            ILogger log)
        {
            log.LogInformation($"C# Blob trigger function Processed blob\n Name:{name} \n Size: {myBlob.Length} Bytes");
        }
    }
}

注意：本地开发时，连接字符串要写在local.settings.json里：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "你的存储账户连接字符串",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet"
  }
}

别忘了把local.settings.json的“复制到输出目录”设置为“始终复制”，不然本地运行时会找不到配置。

5. 给ILogger写单元测试 #

既然你想替代TraceWriter做单元测试，这里给你一个简单示例，用Microsoft.Extensions.Logging.Abstractions里的工具来模拟日志：

using Xunit;
using System.IO;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.Logging.Abstractions;
using Moq;

namespace sampleapplication.Tests
{
    public class Function1Tests
    {
        [Fact]
        public void Run_ProcessesBlob_Correctly()
        {
            // 准备测试数据
            var testBlob = new MemoryStream(System.Text.Encoding.UTF8.GetBytes("test content"));
            // 用Moq模拟ILogger，方便验证日志输出
            var mockLogger = new Mock<ILogger<Function1>>();

            // 执行函数
            Function1.Run(testBlob, "test-file.txt", mockLogger.Object);

            // 验证日志是否正确输出了一次
            mockLogger.Verify(l => l.LogInformation(It.IsAny<string>()), Times.Once);
        }
    }
}

常见问题排查 #

• 如果还是报错，先检查项目是不是**Azure Functions v2+**的模板（创建时选.NET Core/.NET 5+的选项）
• 确认所有NuGet包版本一致，避免版本冲突
• 云端部署时，记得在Azure门户的应用设置里配置好AzureWebJobsStorage这个连接字符串

内容的提问来源于stack exchange，提问作者code-geek