VSCode DevContainers中Dapr Init自动执行失败：Docker Runtime不可用

在DevContainer中配置postStartCommand: "dapr init"时，会报错：

❌ could not connect to docker. docker may not be installed or running

但手动执行dapr init却正常运行，添加固定时长的sleep也无法解决问题——核心原因是**postStartCommand触发时，Docker-in-Docker服务还未完全初始化完成**，固定等待时间无法适配不同环境的启动速度。

解决方案：循环等待Docker就绪后再执行dapr init #

替换postStartCommand为一段循环检查Docker状态的命令，直到Docker可用后再初始化Dapr，这样比固定sleep更可靠。

修改后的devcontainer.json配置：

{
  "name": "Dapr Quickstarts Codespace",
  "dockerFile": "Dockerfile",
  "customizations": {
    "vscode": {
      "extensions": [
        "golang.go",
        "ms-azuretools.vscode-dapr",
        "ms-azuretools.vscode-docker",
        "ms-kubernetes-tools.vscode-kubernetes-tools",
        "ms-dotnettools.csdevkit"
      ]
    }
  },
  "features": {
    "ghcr.io/dapr/cli/dapr-cli:0": {},
    "ghcr.io/devcontainers/features/docker-in-docker:2": {}
  },
  "mounts": [
    // Mount docker-in-docker library volume
    "source=codespaces-linux-var-lib-docker,target=/var/lib/docker,type=volume"
  ],
  "postStartCommand": "until docker info > /dev/null 2>&1; do echo \"Waiting for Docker to start...\"; sleep 5; done && dapr init",
  // Always run image-defined docker-init.sh to enable docker-in-docker
  "overrideCommand": false,
  "remoteUser": "codespace",
  "runArgs": [
    // Enable ptrace-based debugging for Go in container
    "--cap-add=SYS_PTRACE",
    "--security-opt",
    "seccomp=unconfined",

    // Enable docker-in-docker configuration
    "--init",
    "--privileged"
  ]
}

原理说明 #

• docker info > /dev/null 2>&1：静默检查Docker服务是否就绪，无输出则表示服务正常
• until ...; do ...; done：循环执行检查逻辑，直到Docker就绪
• 每次检查间隔5秒，避免频繁占用资源，可根据需要调整sleep时长

如果需要更健壮的逻辑（比如设置最大重试次数），可以将postStartCommand替换为以下脚本命令：

#!/bin/bash
MAX_RETRIES=20
RETRY_INTERVAL=5

for ((i=0; i<MAX_RETRIES; i++)); do
    if docker info > /dev/null 2>&1; then
        echo "Docker is ready, initializing Dapr..."
        dapr init
        exit 0
    fi
    echo "Docker not ready yet, retrying in $RETRY_INTERVAL seconds (attempt $((i+1))/$MAX_RETRIES)..."
    sleep $RETRY_INTERVAL
done

echo "Failed to wait for Docker to start after $((MAX_RETRIES*RETRY_INTERVAL)) seconds"
exit 1

将这段脚本保存为wait-docker-and-init-dapr.sh，然后在postStartCommand中设置为bash wait-docker-and-init-dapr.sh（需确保脚本在容器内可访问）。

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