WSL无Docker Desktop环境下Azure Event Hubs模拟器Docker启动失败

1. 容器网络访问方式错误 #

在同一docker-compose.yml编排的容器集群中，必须使用服务名而非固定IP进行跨容器通信——WSL2环境下容器IP是动态分配的，手动指定IP必然会因IP变更导致连接失效。

• 解决：在Event Hubs的Config.json中，将BLOB_SERVER和METADATA_SERVER设置为Azurite在compose配置里的服务名（例如azurite），默认情况下compose会自动为所有服务创建专属通信网络，无需额外配置。

2. 容器启动顺序未配置，依赖服务未就绪 #

Event Hubs模拟器启动后会立即执行健康检查，若此时Azurite还未完成初始化，就会触发健康状态异常导致容器崩溃。

• 解决：在compose的Event Hubs服务配置中添加依赖等待逻辑，确保Azurite就绪后再启动Event Hubs：

  services:
    eventhubs:
      # 其他原有配置
      depends_on:
        azurite:
          condition: service_healthy
    azurite:
      # 其他原有配置
      healthcheck:
        test: ["CMD", "curl", "-f", "http://localhost:10000/devstoreaccount1"]
        interval: 5s
        timeout: 10s
        retries: 5
  

3. WSL2文件系统权限冲突 #

如果Azurite容器挂载了WSL本地目录作为存储路径，Ubuntu 24.04的默认文件权限（如root用户权限）会导致Azurite无法读写数据，进而让Event Hubs连接失败。

• 解决：要么放弃本地目录挂载，使用容器内部存储；要么修改挂载目录的权限匹配Azurite容器默认用户：

  chown -R 1000:1000 ./azurite-data
  

4. Docker/Compose版本兼容性问题 #

Ubuntu 24.04自带的Docker或Docker Compose版本可能与Azure Event Hubs模拟器镜像存在兼容性差异，比如网络栈或API调用逻辑不匹配。

• 解决：升级Docker到官方最新稳定版，同时确保使用Docker Compose v2版本：

  # 卸载旧版本
  sudo apt remove docker docker-engine docker.io containerd runc
  # 安装官方最新版
  curl -fsSL https://get.docker.com -o get-docker.sh
  sudo sh get-docker.sh
  # 验证版本
  docker --version
  docker compose version
  

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