页面

主题

工具

↑↓移动↵打开esc关闭
编码 · 安全

状态与退出码查询

在一处搜索 HTTP 状态码、Docker 与 Kubernetes 退出码和网络 errno。每条都给出原因、可以立刻执行的检查命令以及能否重试。

完全在浏览器中运行 — 粘贴的内容不会被上传。

快捷查找
42 个代码每条都列出原因、下一步可执行的检查命令,以及能否重试。
  • 200OK可以重试HTTP

    请求成功,响应体中带有结果。若返回 200 但响应体为空,多半是缓存或异常分支在返回响应。

    • curl -i https://example.com/api/health
    • curl -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/items
    • echo '{"name":"test"}' | python3 -m json.tool
    • 先修复原因再重试,现在重发结果不会变。
  • 401Unauthorized修复后重试HTTP

    缺少或无效的身份凭证:没有 Authorization 头、令牌过期、认证方式不对。用 WWW-Authenticate 响应头确认服务器要求的方案。

    • curl -i -H "Authorization: Bearer $TOKEN" https://example.com/api/me
    • curl -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/42
    • curl -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.zip
    • curl -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-after
    • sleep 5 && curl -i https://example.com/api/items
    • 可以直接重发同一个请求。
  • 500Internal Server Error可以重试HTTP

    服务器抛出了未处理的错误。堆栈在服务器日志里,只出现在某个路由的 500 指向该处理函数,而不是网络。

    • curl -i https://example.com/api/items
    • docker 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-after
    • docker 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/slow
    • psql "$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 100
    • kubectl 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 3000
    • ss -ltnp | grep 3000
    • docker compose ps
    • 可以直接重发同一个请求。
  • ECONNRESETECONNRESET可以重试网络 Errno

    请求过程中对端关闭了连接:对端崩溃或超时,代理或负载均衡清掉了空闲连接,或往 TLS 端口发了 HTTP。

    • curl -v https://example.com/api/items
    • curl -v --http1.1 --keepalive-time 30 https://example.com/
    • 可以直接重发同一个请求。
  • ETIMEDOUTETIMEDOUT可以重试网络 Errno

    在时限内没有收到响应:路由、防火墙或安全组、主机填错,或对端太慢。改代码之前先用工具测端口。

    • nc -vz -w 5 <host> 443
    • curl -sS -o /dev/null -w '%{time_connect}s %{time_total}s\n' https://example.com/
    • 可以直接重发同一个请求。
  • ENOTFOUNDENOTFOUND修复后重试网络 Errno

    主机名解析失败:拼写错误、缺少搜索域、容器没有 DNS,或解析器被限流。

    • getent hosts api.example.com
    • nslookup api.example.com 1.1.1.1
    • 先修复原因再重试,现在重发结果不会变。
  • EADDRINUSEEADDRINUSE修复后重试网络 Errno

    本机上该端口已被占用:另一个进程,或没有退出的旧实例仍握着它。

    • lsof -i :3000
    • kill -15 $(lsof -t -i :3000)
    • 先修复原因再重试,现在重发结果不会变。
  • EACCESEACCES修复后重试网络 Errno

    权限被拒绝:没有权限却打开 1024 以下的端口,或进程无法写入的文件与目录。容器里常见的是非 root 用户配 root 拥有的卷。

    • id
    • ls -ld /var/lib/app
    • PORT=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 指南