ASP.NET Core 6 Web API配置Azure Blob日志失败求助

核心排查与修复步骤 #

1. 补全日志提供器配置 #

你当前添加的AddAzureClients是用于Blob/Queue客户端操作的，并非日志写入的配置。需要在Program.cs中显式添加Azure Blob日志提供器：

builder.Logging.AddAzureBlobStorage(options =>
{
    options.ConnectionString = builder.Configuration["MyConnection:blob"];
    options.ContainerName = "logs"; // 确保该容器已在Azure存储账户中创建
    options.BlobNameFormat = "{yyyy}/{MM}/{dd}/application.log"; // 自定义日志文件路径格式
    options.RetentionPolicy = RetentionPolicy.None; // 根据需求设置日志保留策略
});

2. 验证日志级别配置 #

确保appsettings.json中日志级别配置正确，避免日志被过滤：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    },
    "AzureBlobStorage": {
      "LogLevel": {
        "Default": "Information" // 确保该级别包含你要写入的日志
      }
    },
    "MyConnection": {
      "blob": "你的Blob存储连接字符串"
    }
  }
}

3. 检查容器与权限 #

• 确认Blob容器已创建，访问级别设为容器或Blob（私有容器需确保连接字符串包含有效密钥）
• 验证连接字符串正确性：使用Azure存储账户的"Blob服务"连接字符串，而非存储账户的通用连接字符串

4. 触发日志并等待缓冲 #

Azure Blob日志默认有缓冲机制，不会即时写入。在代码中手动触发日志：

app.MapGet("/trigger-log", (ILogger<Program> logger) =>
{
    logger.LogInformation("测试Blob日志写入");
    return "日志已触发，请等待数分钟后查看Blob容器";
});

访问该接口后，等待5-10分钟再检查Blob容器内的日志文件。

5. 确认部署后的配置同步 #

在Azure Portal的App Service中，进入配置>应用设置，检查MyConnection:blob是否已正确配置（本地配置需同步至云端）。

替代方案：使用Serilog写入Blob #

如果上述方案仍未生效，推荐使用更稳定灵活的Serilog方案：

1. 安装NuGet包：

Install-Package Serilog.AspNetCore
Install-Package Serilog.Sinks.AzureBlobStorage

2. 在Program.cs中配置Serilog：

var builder = WebApplication.CreateBuilder(args);

// 替换默认日志系统为Serilog
builder.Host.UseSerilog((context, config) =>
{
    config.WriteTo.AzureBlobStorage(
        connectionString: context.Configuration["MyConnection:blob"],
        containerName: "logs",
        blobNameFormat: "{yyyy}/{MM}/{dd}/serilog.log"
    )
    .ReadFrom.Configuration(context.Configuration);
});

// 后续代码保持不变
var app = builder.Build();

app.MapGet("/test-serilog", (ILogger<Program> logger) =>
{
    logger.LogInformation("Serilog测试Blob日志写入");
    return "Serilog日志已触发";
});

app.Run();

3. appsettings.json中添加Serilog配置：

{
  "Serilog": {
    "MinimumLevel": {
      "Default": "Information",
      "Override": {
        "Microsoft.AspNetCore": "Warning"
      }
    }
  },
  "MyConnection": {
    "blob": "你的Blob存储连接字符串"
  }
}

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