如何在本地Docker容器中配置Azure Table Storage及排查连接问题

1. 修复CreateIfNotExists()重试失败问题 #

首先要确保代码连接的是Docker容器内的Azurite，而非本地实例：

• 使用正确的Docker Azurite连接字符串，格式如下：

  DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;TableEndpoint=http://localhost:10002/devstoreaccount1;
  

  重点是TableEndpoint要明确指向Docker映射的本地10002端口。
• 初始化TableServiceClient时关闭重试策略，获取原始错误（方便定位根本问题）：

  var connectionString = "你的Docker Azurite连接字符串";
  var clientOptions = new TableClientOptions
  {
      RetryPolicy = new NoRetry()
  };
  var tableServiceClient = new TableServiceClient(connectionString, clientOptions);
  await tableServiceClient.CreateTableIfNotExistsAsync("目标表名");
  

  如果报错是连接超时，说明容器端口没映射对；如果是认证错误，检查账户名/密钥是否匹配Docker Azurite的默认值。

2. 解决Docker Azurite认证失败与本地实例冲突问题 #

为什么UseDevelopmentStorage=true连的是本地Azurite？ #

这个连接字符串默认指向本地10002端口，若本地已有Azurite进程（比如VS自带的），会优先连接本地。解决步骤：

1. 停止本地所有Azurite进程（VS的话关闭对应的终端，命令行启动的用Ctrl+C终止）
2. 修正docker-compose.yml的端口映射与卷配置（避免语法错误）：

   services:
     azurite:
       image: mcr.microsoft.com/azure-storage/azurite
       ports:
         - "10000:10000" # Blob存储端口
         - "10001:10001" # Queue存储端口
         - "10002:10002" # Table存储端口
       volumes:
         - azurite_data:/data # 命名卷存储数据，避免权限与路径问题
   volumes:
     azurite_data: # 定义命名卷
   

3. 用curl验证容器连接（替换日期为当前UTC时间）：

   curl -X GET "http://localhost:10002/devstoreaccount1?restype=service&comp=properties" \
   -H "Authorization: SharedKey devstoreaccount1:Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==" \
   -H "x-ms-date: Wed, 10 Oct 2024 12:00:00 GMT" \
   -H "x-ms-version: 2020-08-04"
   

   返回200则说明认证正常。

3. 用Azure Storage Explorer连接Docker Azurite #

1. 打开Azure Storage Explorer，左侧点击「添加账户」
2. 选择「本地存储模拟器」，点击「下一步」
3. 勾选「使用自定义端口」，填写：
   • 账户名：devstoreaccount1
   • 账户密钥：Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==
   • 表存储端口：10002
4. 点击「连接」，即可查看容器内的存储数据。

4. docker-compose volumes语法错误修复 #

常见错误及修正：

• 缩进错误：YAML要求层级用2个空格缩进，禁止用Tab，比如volumes要和services同级
• 绑定挂载路径错误：若要使用本地文件夹而非命名卷，确保路径正确：

  volumes:
    - ./azurite_data:/data # 本地当前目录下的azurite_data文件夹映射到容器/data
  

  提前创建azurite_data文件夹，避免权限问题。

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