Simple Jenkins Pipeline在Docker中运行异常，请求排查指导

我之前在OSX环境下调试过类似的Jenkins+Docker Pipeline故障，给你梳理几个针对性的排查方向，一步步缩小问题范围：

• 先抓准Pipeline的崩溃点
  直接查看Jenkins Pipeline的完整控制台日志，重点搜索和docker exec、容器ID相关的报错信息——比如有没有“container not running”“permission denied”“connection refused”这类明确提示。如果日志被截断，记得在Jenkins全局设置里调大日志输出长度，确保能看到完整的错误栈。

• 手动模拟Pipeline的容器操作
  登录到运行Jenkins的OSX机器，切换到Jenkins服务使用的用户（通常是jenkins或者你自定义的用户），手动执行Pipeline里的docker exec命令，比如：

  docker exec -it <你的容器ID> <Pipeline里要执行的命令>
  

  如果手动执行也失败，那问题大概率不在Jenkins Pipeline本身，而是OSX系统、Docker配置或者容器本身的问题；如果手动能成功，那就要排查Jenkins的环境变量、权限上下文或者插件的问题。

• 检查Docker权限与系统更新

  • 确认Jenkins用户是否在docker用户组里：执行groups jenkins看结果里有没有docker，如果没有，添加后重启Jenkins服务。
  • 检查OSX最近有没有系统更新（比如升级到Sonoma之类的），macOS大版本更新可能会重置Docker Desktop的权限，去系统偏好设置 > 安全性与隐私里看看有没有阻止Jenkins访问Docker的提示，或者重新给Docker Desktop授予全磁盘访问权限。

• 排查Jenkins Docker插件与容器状态

  • 查看Jenkins的Docker插件版本，有没有在两周内自动更新？如果有，尝试回退到之前的稳定版本（插件管理里找历史版本），有时候插件更新会带来兼容性问题。
  • 用docker inspect <容器ID>查看容器的详细状态：确认容器确实处于running状态，健康检查是否通过，有没有因为资源不足被OSX杀掉（OSX的内存回收机制有时候会干掉闲置容器）。另外，Pipeline里是不是在容器启动后立刻执行exec？可以加个sleep 5或者用docker wait等容器就绪后再操作。

• 查看Docker Daemon的调试日志
  在Docker Desktop的设置里开启调试模式，然后查看Daemon的日志（路径通常是~/Library/Containers/com.docker.docker/Data/log/vm/dockerd.log），搜索exec相关的日志，能看到更底层的错误原因——比如容器的文件系统问题、网络命名空间异常等。

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