Docker 提供了两种官方机制判断 docker exec 命令是否结束：非分离模式下 WebSocket 自动关闭即表示完成；分离模式下可通过 /exec/{id}/json 接口轮询 Running 字段状态。
docker 提供了两种官方机制判断 `docker exec` 命令是否结束：非分离模式下 websocket 自动关闭即表示完成；分离模式下可通过 `/exec/{id}/json` 接口轮询 `running` 字段状态。
在使用 Docker REST API 执行容器内命令（例如触发 Maven 构建）时，准确感知命令生命周期至关重要——这直接关系到构建结果的获取、错误处理和后续流程编排。Docker 原生支持两种可靠的方式实现完成态检测：
✅ 方式一：非分离模式（Detach: false）——推荐用于短时同步任务
当调用 /exec/{id}/start 时，不设置 Detach: true（即保持 Detach: false），Docker 会将 exec 进程的标准输入/输出/错误流通过 WebSocket 或长连接返回，并在命令退出后自动关闭连接。客户端只需监听连接关闭事件（如 onclose 或 HTTP 流 EOF），即可确认命令已终止。此时还可通过响应头中的 X-Content-Length 或响应体末尾的 {"stream":false,"error":"..."} 结构获取退出码与错误信息（需启用 Tty: false 以获得结构化输出）。
示例（cURL 启动非分离 exec 并等待结束）：
# 1. 创建 exec 实例（注意：Stdin=true, Tty=false）
curl -s -X POST \
--header "Content-Type: application/json" \
--data '{"AttachStdin":true,"AttachStdout":true,"AttachStderr":true,"Cmd":["mvn","clean","package"],"Tty":false,"Privileged":false}' \
http://localhost:2375/v1.25/containers/my-app/exec
# 响应返回 exec ID，例如：{"Id":"abc123..."}
# 2. 启动 exec 并阻塞等待完成（WebSocket 或 HTTP chunked stream）
curl -s -N -X POST \
--header "Content-Type: application/json" \
--data '{"Detach":false,"Tty":false}' \
http://localhost:2375/v1.25/exec/abc123/start
# → 连接将在 mvn 命令退出后自动断开✅ 方式二：分离模式（Detach: true）——适用于后台长期任务或需复用连接场景
若必须分离执行（如避免连接阻塞），则需配合 /exec/{id}/json 接口轮询。关键字段为 Running（布尔值）和 ExitCode（整数）。当 Running 变为 false 且 ExitCode 存在时，即表示命令已退出。建议轮询间隔 ≥500ms，避免高频请求影响 API 性能。
# 轮询检查（Bash 示例）
EXEC_ID="abc123"
while true; do
status=$(curl -s http://localhost:2375/v1.25/exec/$EXEC_ID/json | jq '.Running')
if [[ "$status" == "false" ]]; then
exit_code=$(curl -s http://localhost:2375/v1.25/exec/$EXEC_ID/json | jq '.ExitCode')
echo "Command finished with exit code: $exit_code"
break
fi
sleep 1
done⚠️ 注意事项与常见陷阱
- 若通过 exec 启动交互式 shell（如
/bin/sh）并持续写入命令但未关闭 stdin，shell 将保持运行状态（Running: true），即使所有命令已执行完毕——这与宿主机中sh -c 'cmd'的行为一致。解决方案是显式关闭 stdin（如curl中不传--data-binary @-或发送 FIN 包），或改用非交互式执行（如sh -c 'mvn clean package'）。 -
Tty: true会禁用结构化输出，导致无法可靠解析ExitCode，生产环境建议始终设为false。 - 所有 exec 实例默认无超时，长时间运行任务建议在应用层添加超时控制（如
timeout命令包裹或客户端定时中断）。
综上，无需“另起炉灶”——Docker REST API 已提供语义清晰、可组合的完成态反馈机制。合理选择分离模式、正确配置 Tty 与 Stdin，再辅以轻量轮询或连接监听，即可稳健实现命令生命周期管理。
