使用 Docker Engine API 的 ContainerExecInspect 无法可靠获取命令退出码，因其可能在命令结束前返回默认值 0；应改用 ContainerExecAttach 配合流读取（等待 EOF）来同步等待命令执行完成并准确捕获退出状态。
使用 docker engine api 的 `containerexecinspect` 无法可靠获取命令退出码，因其可能在命令结束前返回默认值 0；应改用 `containerexecattach` 配合流读取（等待 eof）来同步等待命令执行完成并准确捕获退出状态。
在通过 Docker Engine API（如 github.com/docker/engine-api 或现代替代方案 github.com/docker/docker/api/types + github.com/docker/docker/client）对运行中的容器执行命令时，一个常见误区是依赖 ContainerExecInspect 轮询获取退出码。该方式本质上是异步轮询，而 Inspect 返回的 ExitCode 字段在命令尚未结束时可能为 0（初始值），导致误判——尤其当命令执行时间较短或调度存在竞争时，极易返回错误的 0，而非真实的 233 等非零码。
根本解决方案是：放弃轮询 Inspect，转而使用阻塞式 ContainerExecAttach，通过读取标准输出流直至 EOF，实现自然同步等待。Docker 在 exec 进程退出后会主动关闭 attach 连接，因此读取到 io.EOF 即代表命令已终止，此时再调用 ContainerExecInspect 获取的 ExitCode 才是最终、可信的结果。
以下是关键实践要点与示例代码（基于现代 docker/client v24+）：
✅ 必需配置 ExecConfig：
execConfig := types.ExecConfig{
Cmd: []string{"/bin/sh", "-c", "exit 233"}, // 支持 shell 脚本
AttachStdout: true, // 必须启用，否则无流可读
AttachStderr: true, // 建议同时启用以捕获错误输出
Tty: false, // 避免伪终端干扰流式读取
Detach: false, // 关键！设为 false 实现阻塞 attach
}✅ 执行并同步等待：
// 1. 创建 exec
resp, err := cli.ContainerExecCreate(ctx, containerID, execConfig)
if err != nil {
log.Fatal("Exec create failed:", err)
}
execID := resp.ID
// 2. Attach 并阻塞读取 stdout/stderr 直至 EOF
attachResp, err := cli.ContainerExecAttach(ctx, execID, types.ExecStartCheck{Detach: false})
if err != nil {
log.Fatal("Exec attach failed:", err)
}
defer attachResp.Close()
// 3. 读取 stdout（可同时用 goroutine 读 stderr）
var stdoutBuf, stderrBuf bytes.Buffer
_, _ = io.Copy(&stdoutBuf, attachResp.Reader) // 阻塞直到连接关闭
// 4. 此时命令必定已退出，安全获取退出码
inspect, err := cli.ContainerExecInspect(ctx, execID)
if err != nil {
log.Fatal("Exec inspect failed:", err)
}
fmt.Printf("Command exited with code: %d\n", inspect.ExitCode)
fmt.Printf("Stdout: %s\n", stdoutBuf.String())⚠️ 注意事项：
- 不要设置
Detach: true，否则Attach立即返回，无法同步； -
AttachStdout和/或AttachStderr至少启用其一，否则连接不会因命令退出而关闭； - 若命令不产生输出，仍需读取（哪怕仅
io.ReadFull(conn, make([]byte,0))），否则连接可能不关闭； - 对于 shell 脚本（如
/bin/bash -c "xxx"），该方案完全适用，无需容器重启或停止； - 生产环境建议添加上下文超时（
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)），避免无限阻塞。
综上，ContainerExecAttach + EOF 同步机制是 Docker API 中获取 exec 命令真实退出码最健壮、最符合设计意图的方式，彻底规避了轮询竞态问题，适用于任意命令类型和长/短生命周期场景。
