Azure Functions V3启动文件异常无法在Azure门户日志中捕获

你遇到的问题核心在于：Function App V3的Startup阶段（IWebJobsStartup执行时），Host还未完全初始化，导致ILogger/App Insights无法正常工作，同时同步阻塞调用异步方法可能引发死锁或未被捕获的异常。下面给你一步步的解决方案：

1. 修复异步方法调用方式（避免死锁+确保异常可被捕获） #

你当前用CheckSomeBlobsFiles(...).GetAwaiter().GetResult()同步阻塞异步方法，这在Startup的同步上下文里很容易导致死锁，而且一旦抛出异常，Host启动直接失败，此时App Insights的管道还没就绪，自然捕获不到。

推荐改用异步初始化服务，把检查逻辑放到IHostedService中，这样Host启动完成后再执行检查，此时日志和App Insights都能正常工作：

步骤1：创建异步初始化HostedService #

public class BlobCheckHostedService : IHostedService
{
    private readonly ILogger<BlobCheckHostedService> _logger;
    private readonly string _connectionString;
    private readonly string _containerName;
    private readonly string _directoryName;

    public BlobCheckHostedService(ILogger<BlobCheckHostedService> logger, 
        IConfiguration configuration)
    {
        _logger = logger;
        // 从配置中读取参数，避免硬编码
        _connectionString = configuration.GetValue<string>("BlobConnectionString");
        _containerName = configuration.GetValue<string>("BlobContainerName");
        _directoryName = configuration.GetValue<string>("BlobDirectoryName");
    }

    public async Task StartAsync(CancellationToken cancellationToken)
    {
        try
        {
            await CheckSomeBlobsFiles(_connectionString, _containerName, _directoryName);
            _logger.LogInformation("Blob check completed successfully");
        }
        catch (Exception e)
        {
            var errorMsg = $"Error while checking blob files: {e.Message}";
            _logger.LogError(e, errorMsg);
            // 如果检查失败需要终止Host，可以抛出异常
            throw new InvalidOperationException(errorMsg, e);
        }
    }

    public Task StopAsync(CancellationToken cancellationToken) => Task.CompletedTask;

    private async Task CheckSomeBlobsFiles(string connectionString, string containerName, string directoryName)
    {
        // 你的Blob检查逻辑
    }
}

步骤2：在Startup.cs中注册HostedService #

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

[assembly: WebJobsStartup(typeof(YourNamespace.Startup))]
namespace YourNamespace
{
    public class Startup : IWebJobsStartup
    {
        public void Configure(IWebJobsBuilder builder)
        {
            // 注册异步初始化服务
            builder.Services.AddHostedService<BlobCheckHostedService>();
        }
    }
}

这样修改后，检查逻辑在Host启动完成后执行，异常会被ILogger捕获并发送到App Insights，同时日志也能正常输出。

2. 如果必须在Startup阶段执行检查（捕获日志+异常） #

如果你的检查逻辑必须在Host启动前执行，那需要用原生日志方式，因为此时ILogger还未被注入。可以用Trace或者直接写入Console，这些日志会出现在Azure Portal的日志流中：

using System.Diagnostics;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Hosting;
using Microsoft.Extensions.Configuration;

[assembly: WebJobsStartup(typeof(YourNamespace.Startup))]
namespace YourNamespace
{
    public class Startup : IWebJobsStartup
    {
        public void Configure(IWebJobsBuilder builder)
        {
            try
            {
                var configuration = builder.Services.BuildServiceProvider().GetService<IConfiguration>();
                var connectionString = configuration.GetValue<string>("BlobConnectionString");
                var blobContainerName = configuration.GetValue<string>("BlobContainerName");
                var blobDirectoryName = configuration.GetValue<string>("BlobDirectoryName");

                Trace.TraceInformation("Starting blob check in Startup...");
                CheckSomeBlobsFiles(connectionString, blobContainerName, blobDirectoryName).GetAwaiter().GetResult();
                Trace.TraceInformation("Blob check in Startup completed successfully");
            }
            catch (Exception e)
            {
                var errorMsg = $"Error while checking blob files: {e.Message}";
                Trace.TraceError(errorMsg);
                Trace.TraceError(e.StackTrace);
                // 抛出异常终止Host启动
                throw new Exception(errorMsg, e);
            }
        }

        private async Task CheckSomeBlobsFiles(string connectionString, string containerName, string directoryName)
        {
            // 你的Blob检查逻辑
        }
    }
}

此时异常和日志会出现在：

• Azure Portal -> 你的Function App -> 平台功能 -> 日志流
• 本地调试时的输出窗口

3. 为什么App Insights捕获不到Startup阶段的异常？ #

Function App V3的App Insights集成是在Host启动过程中初始化的，而IWebJobsStartup.Configure是在Host启动之前执行的。此时TelemetryClient还未被创建，所以异常无法被自动捕获到App Insights。只有Host启动完成后，后续的异常才能被App Insights捕获。

额外提示：避免在Startup中做耗时操作 #

Startup阶段的操作会影响Function App的启动时间，如果检查逻辑耗时较长，可能导致启动超时被Azure平台终止。推荐把这类初始化逻辑放到IHostedService中，或者改为延迟初始化（第一次调用函数时执行）。

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