状态与退出码查询
在一处搜索 HTTP 状态码、Docker 与 Kubernetes 退出码和网络 errno。每条都给出原因、可以立刻执行的检查命令以及能否重试。
完全在浏览器中运行 — 粘贴的内容不会被上传。
- 200OK可以重试HTTP
请求成功,响应体中带有结果。若返回 200 但响应体为空,多半是缓存或异常分支在返回响应。
curl -i https://example.com/api/healthcurl -sS https://example.com/api/health | head -c 200- 可以直接重发同一个请求。
- 201Created不要重试HTTP
请求创建了资源。Location 响应头指向新记录,缺少它时客户端很难继续后续请求。
curl -i -X POST -H 'Content-Type: application/json' -d '{"name":"test"}' https://example.com/api/items- 重复同一个请求只会得到同样的响应。
- 204No Content不要重试HTTP
请求成功,响应没有正文。习惯解析 JSON 的代码会在这里报 unexpected end of JSON input。
curl -i -X DELETE https://example.com/api/items/42- 重复同一个请求只会得到同样的响应。
- 301Moved Permanently可以重试HTTP
URL 已永久变更,客户端会缓存重定向。只有旧路径永不恢复时才用它,临时迁移请用 302 或 307。
curl -sSIL https://example.com/old-path- 可以直接重发同一个请求。
- 302Found可以重试HTTP
临时重定向,但客户端可能把 POST 改成 GET。API 需要保留方法时请用 307 或 308。
curl -sSIL https://example.com/login- 可以直接重发同一个请求。
- 304Not Modified可以重试HTTP
缓存副本仍然有效,因此没有发送正文。只有带 If-None-Match 或用 If-Modified-Since 时才会出现,在日志里不是错误。
curl -i -H 'If-None-Match: "etag"' https://example.com/page- 可以直接重发同一个请求。
- 307Temporary Redirect可以重试HTTP
保留方法和正文的临时重定向,正是需要把 POST 重新发到其他 URL 时该用的响应。
curl -sSIL -X POST https://example.com/api/old- 可以直接重发同一个请求。
- 308Permanent Redirect可以重试HTTP
保留方法和正文的永久重定向。浏览器会缓存它,目标地址填错后很难撤回。
curl -sSIL https://example.com/old- 可以直接重发同一个请求。
- 400Bad Request修复后重试HTTP
服务器读不懂请求:JSON 损坏、缺少必填字段、Content-Type 不对。多数框架会在响应体中指出是哪个字段有问题。
curl -i -X POST -H 'Content-Type: application/json' -d '{"name":"test"}' https://example.com/api/itemsecho '{"name":"test"}' | python3 -m json.tool- 先修复原因再重试,现在重发结果不会变。
- 401Unauthorized修复后重试HTTP
缺少或无效的身份凭证:没有 Authorization 头、令牌过期、认证方式不对。用 WWW-Authenticate 响应头确认服务器要求的方案。
curl -i -H "Authorization: Bearer $TOKEN" https://example.com/api/mecurl -sSI https://example.com/api/me | grep -i www-authenticate- 先修复原因再重试,现在重发结果不会变。
- 403Forbidden修复后重试HTTP
身份已验证但权限不足。检查角色或作用域、存储桶与数据表策略、IP 白名单。登录成功后的 403 是权限问题,不是令牌问题。
curl -i -H "Authorization: Bearer $TOKEN" https://example.com/api/admin- 先修复原因再重试,现在重发结果不会变。
- 404Not Found不要重试HTTP
路径或记录不存在。检查路由、末尾斜杠、base URL 和 id。反向代理剥掉路径前缀时也会得到同样的响应。
curl -sSIL https://example.com/api/items/42curl -sS http://localhost:3000/api- 重复同一个请求只会得到同样的响应。
- 405Method Not Allowed修复后重试HTTP
路由存在但不接受这个方法:向只支持 POST 的接口发了 GET,或代理与表单改写了方法。Allow 响应头列出了允许的方法。
curl -i -X GET https://example.com/api/items- 先修复原因再重试,现在重发结果不会变。
- 408Request Timeout可以重试HTTP
客户端没能在时限内发送完整请求。常见原因是慢速网络上传,或代理超时设置比客户端需要的更短。
curl -sS -o /dev/null -w '%{time_total}s\n' https://example.com/api/upload- 可以直接重发同一个请求。
- 409Conflict修复后重试HTTP
与当前状态冲突:唯一键重复、同一行被并发修改、乐观锁版本不匹配。重新读取后再重试通常是可行的。
curl -i -X POST -H 'Content-Type: application/json' -d '{"email":"a@b.c"}' https://example.com/api/users- 先修复原因再重试,现在重发结果不会变。
- 413Payload Too Large修复后重试HTTP
请求体超过了服务器或前置代理的上限:nginx 的 client_max_body_size、Serverless 请求上限或框架的正文限制。请压缩或分片上传。
du -h ./upload.zipcurl -i -F 'file=@upload.zip' https://example.com/api/upload- 先修复原因再重试,现在重发结果不会变。
- 415Unsupported Media Type修复后重试HTTP
接口不接受这个 Content-Type。最常见的是把 JSON 正文当成表单数据发送,请设为 application/json 并保证正文是合法 JSON。
curl -i -X POST -H 'Content-Type: application/json' -d '{"a":1}' https://example.com/api/items- 先修复原因再重试,现在重发结果不会变。
- 422Unprocessable Entity修复后重试HTTP
格式正确但取值未通过校验。FastAPI、Rails、Laravel 等框架会把字段错误放进响应体,改请求结构之前先读它。
curl -i -X POST -H 'Content-Type: application/json' -d '{"email":"nope"}' https://example.com/api/users- 先修复原因再重试,现在重发结果不会变。
- 429Too Many Requests可以重试HTTP
触发了速率限制或配额。读取 Retry-After,带抖动退避,并确认被限制的是 IP、API 密钥还是登录用户。
curl -sSI https://example.com/api/items | grep -i retry-aftersleep 5 && curl -i https://example.com/api/items- 可以直接重发同一个请求。
- 500Internal Server Error可以重试HTTP
服务器抛出了未处理的错误。堆栈在服务器日志里,只出现在某个路由的 500 指向该处理函数,而不是网络。
curl -i https://example.com/api/itemsdocker compose logs -f --tail 50 api- 可以直接重发同一个请求。
- 502Bad Gateway可以重试HTTP
代理连上了上游但拿不到可用响应:应用崩溃或正在重启、监听在别的端口,或往 TLS 端口发了 HTTP。
curl -sS -o /dev/null -w '%{http_code} %{time_total}s\n' https://example.com/docker compose ps- 可以直接重发同一个请求。
- 503Service Unavailable可以重试HTTP
服务器还活着但无法提供服务:过载、维护模式、依赖服务故障,或负载均衡后面没有健康实例。Retry-After 会告诉何时重试。
curl -sSI https://example.com/ | grep -i retry-afterdocker compose ps- 可以直接重发同一个请求。
- 504Gateway Timeout可以重试HTTP
代理等待上游超过了超时限制。先看慢查询、缺失的索引、proxy_read_timeout 或 Serverless 执行时间上限,再怀疑代码。
curl -sS -o /dev/null -w '%{http_code} %{time_total}s\n' http://localhost:3000/api/slowpsql "$DATABASE_URL" -c 'EXPLAIN ANALYZE SELECT 1'- 可以直接重发同一个请求。
- 0Exit 0 — success可以重试容器与退出码
进程成功结束。对一次性任务正常,对需要长期运行的服务则是错误退出,请确认入口脚本没有做完事就退出。
docker logs --tail 50 <container>docker inspect --format '{{.State.ExitCode}}' <container>- 可以直接重发同一个请求。
- 1Exit 1 — application error修复后重试容器与退出码
应用本身失败:未捕获的异常、断言失败、缺少迁移。原因在容器日志的最后几行。
docker logs --tail 100 <container>docker inspect --format '{{.State.ExitCode}}' <container>- 先修复原因再重试,现在重发结果不会变。
- 2Exit 2 — usage error修复后重试容器与退出码
Shell 内建命令或命令行有误:错误的参数、缺少的实参,或入口脚本里读不到的文件。
docker logs --tail 50 <container>docker run --rm -it --entrypoint sh <image>- 先修复原因再重试,现在重发结果不会变。
- 126Exit 126 — cannot execute修复后重试容器与退出码
命令存在但无法执行:缺少执行权限、shebang 里带 Windows 换行,或镜像里没有对应的解释器。
docker run --rm -it --entrypoint sh <image> -c 'ls -l /entrypoint.sh'file /path/to/entrypoint.sh- 先修复原因再重试,现在重发结果不会变。
- 127Exit 127 — command not found修复后重试容器与退出码
在镜像的 PATH 里找不到该命令:拼写错误、未安装的软件包,或二进制只存在于多阶段构建的另一个阶段。
docker run --rm -it --entrypoint sh <image> -c 'command -v node'docker run --rm -it --entrypoint sh <image> -c 'echo $PATH'- 先修复原因再重试,现在重发结果不会变。
- 130Exit 130 — SIGINT可以重试容器与退出码
进程被 Ctrl-C 停止,即 128 加信号 2。手动中断的容器正常,没人操作却出现就需要检查。
docker inspect --format '{{.State.ExitCode}}' <container>- 可以直接重发同一个请求。
- 137Exit 137 — SIGKILL / OOMKilled修复后重试容器与退出码
容器被 128 加信号 9 强制终止。多数情况是 OOM killer 终止了容器,提高上限之前先比较应用的内存峰值和限制。
docker inspect --format '{{.State.OOMKilled}}' <container>docker stats --no-stream <container>kubectl describe pod <pod> | grep -i -A2 'Last State'- 先修复原因再重试,现在重发结果不会变。
- 139Exit 139 — SIGSEGV修复后重试容器与退出码
进程因段错误崩溃,即 128 加信号 11。为其他 libc 编译的原生模块,或 Node、Python 的 ABI 不匹配时常见。
docker logs --tail 100 <container>docker inspect --format '{{.Config.Image}}' <container>- 先修复原因再重试,现在重发结果不会变。
- 143Exit 143 — SIGTERM可以重试容器与退出码
容器收到了正常的停止信号 SIGTERM(128+15)。若它自行反复出现,说明应用没能在宽限期内完成退出。
docker inspect --format '{{.Config.StopTimeout}}' <container>docker logs --tail 50 <container>- 可以直接重发同一个请求。
- CrashLoopBackOffKubernetes CrashLoopBackOff修复后重试容器与退出码
容器不断退出,Kubernetes 反复重启,重试间隔越来越长。上一次尝试的输出里写着退出的原因。
kubectl logs <pod> --previous --tail 100kubectl describe pod <pod> | grep -i -A5 'Last State'- 先修复原因再重试,现在重发结果不会变。
- ImagePullBackOffKubernetes ImagePullBackOff修复后重试容器与退出码
无法拉取镜像:标签不存在、私有仓库缺少 imagePullSecrets,或仓库对该节点限流。
kubectl describe pod <pod> | sed -n '/Events/,$p'kubectl get secret <secret> -o yaml- 先修复原因再重试,现在重发结果不会变。
- CreateContainerConfigErrorKubernetes CreateContainerConfigError修复后重试容器与退出码
容器无法创建,因为它引用的东西缺失:Secret 或 ConfigMap、它的某个键,或承载它的卷。
kubectl describe pod <pod> | sed -n '/Events/,$p'kubectl get secret,configmap- 先修复原因再重试,现在重发结果不会变。
- EvictedKubernetes Evicted修复后重试容器与退出码
节点内存、磁盘或进程资源不足,Pod 被驱逐。requests/limits 与实际用量不符、节点没有剩余空间是常见原因。
kubectl get pod <pod> -o jsonpath='{.status.reason}{"\\n"}{.status.message}{"\\n"}'kubectl describe node <node> | grep -i -A6 'Conditions'- 先修复原因再重试,现在重发结果不会变。
- ECONNREFUSEDECONNREFUSED可以重试网络 Errno
该 host 和 port 上没有进程在监听,或只监听 127.0.0.1。在 Docker 里要用服务名而不是 localhost,端口也要是容器内的端口。
nc -vz localhost 3000ss -ltnp | grep 3000docker compose ps- 可以直接重发同一个请求。
- ECONNRESETECONNRESET可以重试网络 Errno
请求过程中对端关闭了连接:对端崩溃或超时,代理或负载均衡清掉了空闲连接,或往 TLS 端口发了 HTTP。
curl -v https://example.com/api/itemscurl -v --http1.1 --keepalive-time 30 https://example.com/- 可以直接重发同一个请求。
- ETIMEDOUTETIMEDOUT可以重试网络 Errno
在时限内没有收到响应:路由、防火墙或安全组、主机填错,或对端太慢。改代码之前先用工具测端口。
nc -vz -w 5 <host> 443curl -sS -o /dev/null -w '%{time_connect}s %{time_total}s\n' https://example.com/- 可以直接重发同一个请求。
- ENOTFOUNDENOTFOUND修复后重试网络 Errno
主机名解析失败:拼写错误、缺少搜索域、容器没有 DNS,或解析器被限流。
getent hosts api.example.comnslookup api.example.com 1.1.1.1- 先修复原因再重试,现在重发结果不会变。
- EADDRINUSEEADDRINUSE修复后重试网络 Errno
本机上该端口已被占用:另一个进程,或没有退出的旧实例仍握着它。
lsof -i :3000kill -15 $(lsof -t -i :3000)- 先修复原因再重试,现在重发结果不会变。
- EACCESEACCES修复后重试网络 Errno
权限被拒绝:没有权限却打开 1024 以下的端口,或进程无法写入的文件与目录。容器里常见的是非 root 用户配 root 拥有的卷。
idls -ld /var/lib/appPORT=8080 node server.js- 先修复原因再重试,现在重发结果不会变。
状态与退出码参考
快速参考- 4xx vs 5xx
- 4xx 表示要改的是客户端的请求,5xx 表示服务端失败;只在某条路由出现的 502、504 多半来自代理后面的上游。
- 128 + signal
- Shell 用 128 加信号编号报告被信号终止的进程:137 是 128+9(SIGKILL),143 是 128+15(SIGTERM),139 是 128+11(SIGSEGV)。
- OOMKilled
- docker inspect 里 OOMKilled 为 true 的 137 说明达到了内存上限;上限低于应用峰值时会以同样方式不断重启。
- CrashLoopBackOff
- 容器不断退出、Kubernetes 反复重启的状态;用 kubectl logs --previous 看失败的那次尝试。
- ECONNREFUSED
- 该 host 和 port 上没有进程监听;在 Docker 里主机是服务名而不是 localhost,端口也要写容器端口。
- Retry-After
- 429 或 503 用来告诉何时可以再来;不要紧密循环重试,带抖动退避更合适。
常见问题
答案在工具下方容器以 137 退出是什么意思?
137 是 128+9,即 SIGKILL:要么是内存不足被杀,要么是 docker stop。用 docker inspect 的 OOMKilled 区分。
CrashLoopBackOff 是什么状态?
容器不断退出,Kubernetes 反复重启。用 kubectl logs --previous 看上一次退出的原因。
503 可以重试吗?
可以,但要带抖动退避。通常是上游或容量临时问题,Retry-After 会说明等多久。
Linux 相关语法指南
全部 Linux 指南Linux: Too many open files (EMFILE) and ulimit
EMFILE is a per-process descriptor limit, ENFILE is the kernel's. Read the limit from /proc, raise it in the right layer, and find the leak that made it matter.
Linuxsystemd status=203/EXEC and 217/USER: Exec and Permission Failures
203 is a failed execve, 217 is a user systemd could not resolve. Both happen before your program runs, and the check that finds each takes one command.
Linuxsystemd Timers vs Cron: Missing PATH, Overlapping Runs, Time Drift
Cron runs a bare shell with no profile and no locking, and systemd reads the system time zone. The environment, single-instance and schedule fixes for both.
LinuxBash Indexed Arrays, Associative Maps, and Parameter Expansion
Quoting decides whether an array stays a list, and the expansion operators replace most external text tools. Includes set -u, mapfile, namerefs, and the bash 3.2 differences that break scripts on macOS.