容器异常退出状态码

当容器启动失败或终止时，K8s事件中将会打印容器异常退出状态码（Exit Code）来报告容器异常的原因。本文将介绍如何通过事件中打印的Exit Code进一步定位容器异常的根本原因。

查看容器异常退出状态码

您可使用kubectl连接集群，并通过以下命令查询Pod详细状态：

kubectl describe pod {pod name}

在返回结果中的Exit Code字段即为程序上次退出时的状态码，该值不为0即表示程序异常退出，可根据退出状态码进一步分析异常原因。

Containers: 
  container-1: 
    Container ID: ... 
    Image: ... 
    Image ID: ... 
    Ports: ... 
    Host Ports: ... 
    Args: ... 
    State: Running    
      Started: Sat, 28 Jan 2023 09:06:53 +0000 
    Last State: Terminated    
      Reason: Error    
      Exit Code: 255    
      Started: Sat, 28 Jan 2023 09:01:33 +0000    
      Finished: Sat, 28 Jan 2023 09:05:11 +0000 
    Ready: True 
    Restart Count: 1

退出状态码说明

容器退出状态码的范围为0~255之间：

0表示正常退出。
一般由于程序自身原因导致的异常退出，状态码区间在1~128。在特殊场景下，程序也可以使用129~255区间的状态码。
由于外界中断导致程序退出时，状态码区间在129~255。当操作系统给程序发送中断信号时，程序退出时的状态码为操作系统的中断信号值加128。例如， SIGKILL（强制停止）的中断信号值为9，那么程序退出状态码则为9+128 =137。
当指定的状态码不在0~255范围内时（例如使用exit(-1)），将自动转化至0~255范围内。
当指定的状态码为正数，转换公式如下：
```
code % 256
```
当指定的状态码为负数，转换公式如下：
```
256 - (|code| % 256)
```

更多退出状态码说明请参见Exit Codes With Special Meanings。

常见的容器异常退出状态码

表1 常见的容器异常退出状态码
容器异常退出状态码	名称	含义
0	正常退出	表示容器正常退出。该状态码不一定表示存在异常，例如，当容器内没有进程时，也会出现退出状态码为0的场景。
1	一般程序错误	引起该异常状态的原因较多，大多由于程序自身错误导致，需要进一步通过容器日志定位原因。例如在ARM节点上运行X86镜像时，会出现该错误。
125	容器未能运行	发生这种情况的常见原因有如下几种：命令中使用了未定义的flag，例如docker run --abcd。镜像中用户定义的命令在本机权限不足。容器运行时与宿主机操作系统或硬件不兼容。
126	命令调用错误	镜像中调用的命令无法执行，例如文件权限不足或文件不可执行。
127	找不到文件或目录	无法找到镜像中指定的文件或目录。
128	无效的退出参数	容器退出但未提供有效的退出代码，可能的原因有多种，需要进一步定位原因。例如containerd节点上运行的应用尝试调用docker命令。
137	立即终止（SIGKILL）	表示程序被SIGKILL信号终止，常见的原因有如下几种： Pod中容器内存达到了其资源限制（resources.limits）。例如，内存溢出（OOM）会导致cgroup强制停止该容器。运行容器的节点本身资源不足（OOM），则节点内核会选择停止一些进程来释放内存，可能会导致容器被终止。容器健康检查失败，kubelet会停止该容器。其他外部进程强制停止容器，例如恶意脚本。
139	分段错误（SIGSEGV）	表示容器收到了来自操作系统的SIGSEGV信号，由于容器试图访问无权限的内存位置引起。
143	优雅终止（SIGTERM）	表示容器在主机指示后正确关闭。一般来说，退出码143不需要进行故障排除。
255	状态码超出范围	表示容器退出状态码超出范围。例如，可能是设置异常退出使用exit(-1)导致的，而-1将会自动转换成255。出现该异常时无法判断原因，需要进一步通过容器日志定位原因。

Linux标准中断信号

您可以使用kill -l命令查看Linux操作系统中信号以及对应的数值。

表2 常用的Linux标准中断信号
信号（Signal）	状态码（Value）	动作（Action）	描述（Commit）
SIGHUP	1	Term	用户终端连接（正常或非正常）结束时发出
SIGINT	2	Term	程序终止信号，通常由终端发出中断指令，例如键盘输入Ctrl+C
SIGQUIT	3	Core	和SIGINT类似，由终端发出退出指令，通常是键盘输入Ctrl+\来控制
SIGILL	4	Core	非法指令，通常是因为可执行文件本身出现错误
SIGABRT	6	Core	调用abort函数时产生的信号，进程会非正常结束
SIGFPE	8	Core	发生浮点运算错误，出现除数为0等其它算术错误时也会产生
SIGKILL	9	Term	终止任何进程
SIGSEGV	11	Core	试图访问无权限的内存位置
SIGPIPE	13	Term	管道断开信号
SIGALRM	14	Term	时钟定时信号
SIGTERM	15	Term	进程结束信号，通常是程序自行正常退出
SIGUSR1	10	Term	用户在应用程序中自行定义的信号
SIGUSR2	12	Term	用户在应用程序中自行定义的信号
SIGCHLD	17	Ign	子进程结束或中断时产生该信号
SIGCONT	18	Cont	让一个暂停（stopped）的进程继续执行
SIGSTOP	19	Stop	暂停进程的执行
SIGTSTP	20	Stop	停止进程的运行
SIGTTIN	21	Stop	后台进程从终端读取输入值
SIGTTOU	22	Stop	后台进程从终端读取输出值

父主题：工作负载异常问题排查

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

云宝助手提问云社区提问