如何通过Docker Go SDK获取非运行容器退出码并规避高开销

直接调用ContainerWait是否可行？ #

可行，但完全没必要。ContainerWait的设计初衷是等待容器进入指定状态，哪怕容器已经处于非运行状态，它依然会触发内部的状态监听逻辑，这就是导致10-50ms开销的原因，属于无意义的资源消耗。

更优方案：使用ContainerInspect #

直接调用ContainerInspect接口是更高效的选择，它会直接返回容器的完整元数据，其中就包含退出码字段。因为只是读取已持久化的容器状态数据，不需要等待或监听，开销比ContainerWait低很多。

示例代码 #

package main

import (
	"context"
	"fmt"
	"github.com/docker/docker/api/types"
	"github.com/docker/docker/client"
)

func main() {
	ctx := context.Background()
	cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())
	if err != nil {
		panic(err)
	}
	defer cli.Close()

	containerID := "your-container-id"
	container, err := cli.ContainerInspect(ctx, containerID)
	if err != nil {
		panic(err)
	}

	// 容器非运行时，State.ExitCode即为退出码
	if !container.State.Running {
		fmt.Printf("容器退出码: %d\n", container.State.ExitCode)
	}
}

关键说明 #

• ContainerInspect返回的State结构体中，ExitCode字段在容器非运行状态下会正确填充退出码，不需要额外等待逻辑。
• 这个接口的调用开销远低于ContainerWait，非常适合批量获取或频繁查询退出码的场景。

内容的提问来源于stack exchange，提问作者Lars Kakavandi-Nielsen