使用Docker镜像在Kubernetes部署服务时，卡在Booting worker with pid:7循环

1. 排查应用代码启动异常 #

• 在本地直接执行gunicorn --bind 0.0.0.0:8080 --workers 1 --threads 8 --timeout 0 main:app，验证服务能否正常启动，是否存在启动即报错退出的情况。
• 检查main.py中app对象的初始化逻辑，确认是否存在未捕获的启动异常（比如数据库连接失败、配置文件缺失、依赖包版本不兼容等）。
• 给gunicorn添加调试级日志，修改Dockerfile的CMD命令，获取worker崩溃的具体细节：

  CMD exec gunicorn --bind 0.0.0.0:8080 --workers 1 --threads 8 --timeout 0 --log-level debug main:app
  

2. 检查Kubernetes资源与探针配置 #

• 查看Pod的资源请求和限制设置，若内存/CPU配额不足，worker可能因OOM被杀死或资源不足崩溃，可临时调高资源限制测试。
• 核对LivenessProbe和ReadinessProbe的配置，若探针触发过早或检查逻辑错误，会导致K8s误判Pod不健康并重复重启。
• 执行kubectl describe pod <pod-name>查看Pod事件，确认是否有OOMKilled、CrashLoopBackOff的具体原因提示（如内存不足、命令执行失败等）。

3. 验证Docker镜像的环境与依赖 #

• 构建镜像后进入容器，执行pip list核对requirements.txt中的依赖是否全部正确安装，排查版本冲突或遗漏问题。
• 确认容器内/app目录下存在main.py，执行ls /app检查文件是否完整复制。
• 检查应用依赖的外部服务（如数据库、缓存）在K8s集群内是否可达，连接配置信息是否正确。

4. 调整gunicorn配置参数 #

• 移除--timeout 0参数，替换为合理的超时值（如--timeout 30），无限超时可能导致异常进程无法正常回收。
• 尝试更换worker类型，将gthread改为sync，排查线程模型是否引发问题，修改CMD命令：

  CMD exec gunicorn --bind 0.0.0.0:8080 --workers 1 --timeout 30 --worker-class sync main:app
  

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