清理Azurite后重启.NET 6 Azure Functions遇ContainerNotFound错误

错误原因 #

BlobLeaseDistributionManager是Azure Functions宿主用于分布式任务调度和租约管理的核心组件，它依赖指定的Blob容器存储租约数据。清理Azurite文件夹后，该依赖容器被删除，而函数宿主启动时未自动创建容器，因此触发404状态码的ContainerNotFound错误。

以下是几种可行的解决方案：

方案1：手动创建缺失的容器 #

1. 打开Azure存储工具（VS Code的Azure存储扩展或Azure Storage Explorer），连接本地开发存储（使用连接字符串UseDevelopmentStorage=true）。
2. 在Blob存储分类下，创建错误日志中指定名称的容器（通常默认容器名为azure-webjobs-hosts）。
3. 容器权限设置为私有即可满足需求。

方案2：通过代码自动初始化容器 #

在函数项目的启动代码中添加容器自动创建逻辑，确保每次启动时检查并创建所需容器：

using Azure.Storage.Blobs;
using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureServices(services =>
    {
        services.AddSingleton(sp =>
        {
            var storageConn = Environment.GetEnvironmentVariable("AzureWebJobsStorage");
            var blobClient = new BlobServiceClient(storageConn);
            // 替换为错误提示的容器名称，默认是azure-webjobs-hosts
            var container = blobClient.GetBlobContainerClient("azure-webjobs-hosts");
            container.CreateIfNotExists();
            return blobClient;
        });
    })
    .Build();

host.Run();

方案3：重置Azurite并重新初始化 #

如果Azurite存储数据存在损坏，可彻底重置后重新初始化：

1. 关闭Azurite进程和函数项目的所有运行实例。
2. 删除Azurite的存储文件夹（默认路径为%USERPROFILE%\.azurite，若自定义了路径则删除对应文件夹）。
3. 重新启动Azurite，可使用命令行启动：

   azurite --silent --location "C:\YourCustomAzuritePath" --debug "C:\YourCustomAzuritePath\debug.log"
   

4. 启动函数项目，宿主会自动尝试创建所需的基础容器。

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