logo
GeekFormat

Consulta de codis d'estat HTTP

Codis d'estat d'alta frequència

Resultats de cerca (77)

100
1xx
Continue
已收到请求头，客户端应继续发送请求体
101
1xx
Switching Protocols
服务器正按 Upgrade 切换协议（如 WebSocket）
102
1xx
Processing
已接受请求，处理尚未结束（WebDAV）
103
1xx
Early Hints
在最终响应前返回 Link 等提示以预加载资源
104
1xx
Upload Resumption Supported
表明支持可恢复上传（IANA 临时注册，详见 httpbis 可恢复上传草案）
200
2xx
OK
请求成功
201
2xx
Created
已创建资源
202
2xx
Accepted
已接受，尚未处理完成（异步任务常见）
203
2xx
Non-Authoritative Information
成功，表示可能来自代理/缓存
204
2xx
No Content
成功，无响应体
205
2xx
Reset Content
成功，客户端应重置文档或表单视图
206
2xx
Partial Content
成功返回部分内容（Range）
207
2xx
Multi-Status
多状态 XML响应（WebDAV）
208
2xx
Already Reported
DAV 绑定成员已在先前响应中列出（WebDAV）
226
2xx
IM Used
已应用实例操作（Delta 编码，RFC 3229）
300
3xx
Multiple Choices
多种表示可选，需选择或重定向
301
3xx
Moved Permanently
资源永久迁移至新 URI
302
3xx
Found
资源临时位于其他 URI
303
3xx
See Other
应使用 GET 访问另一 URI 获取结果
304
3xx
Not Modified
缓存仍有效
305
3xx
Use Proxy
须经由代理（已弃用，不建议实现）
306
3xx
(Unused)
历史占位，HTTP/1.1 起未使用
307
3xx
Temporary Redirect
临时重定向，方法与正文不变
308
3xx
Permanent Redirect
永久重定向，方法与正文不变
400
4xx
Bad Request
语法无效，无法解析
401
4xx
Unauthorized
需身份验证（常配合 WWW-Authenticate）
402
4xx
Payment Required
预留，极少实现
403
4xx
Forbidden
拒绝访问（与401 不同：未必缺凭证）
404
4xx
Not Found
未找到资源
405
4xx
Method Not Allowed
该 URI 不支持此 HTTP 方法
406
4xx
Not Acceptable
无法生成 Accept 可接受的表示
407
4xx
Proxy Authentication Required
需先通过代理认证
408
4xx
Request Timeout
等待请求超时
409
4xx
Conflict
与资源当前状态冲突
410
4xx
Gone
资源曾存在且已永久移除
411
4xx
Length Required
缺少有效 Content-Length 等
412
4xx
Precondition Failed
前置条件（如 If-*）不满足
413
4xx
Content Too Large
请求体过大（RFC 9110 用语）
414
4xx
URI Too Long
URI 过长
415
4xx
Unsupported Media Type
不支持的媒体类型
416
4xx
Range Not Satisfiable
无法满足 Range
417
4xx
Expectation Failed
无法满足 Expect 头
418
4xx
(Unused)
RFC 9110 标记未使用；典故为 RFC 2324「I'm a teapot」
421
4xx
Misdirected Request
请求未指向能响应的服务器/连接（如 HTTP/2）
422
4xx
Unprocessable Content
语义可理解但无法处理（校验失败等）
423
4xx
Locked
资源被锁定（WebDAV）
424
4xx
Failed Dependency
依赖请求失败（WebDAV）
425
4xx
Too Early
拒绝可能重放的过早请求
426
4xx
Upgrade Required
需升级到 Upgrade 指定的协议
428
4xx
Precondition Required
源站要求条件请求以防冲突
429
4xx
Too Many Requests
请求过于频繁，应限速
431
4xx
Request Header Fields Too Large
请求头整体或单项过大
444
vendor
No Response (nginx)
Nginx 直接关连接不返回状态行（常见于限流/屏蔽）
451
4xx
Unavailable For Legal Reasons
因法律原因不可提供
495
vendor
SSL Certificate Error (nginx)
Nginx：客户端证书校验失败
496
vendor
SSL Certificate Required (nginx)
Nginx：需要客户端证书
497
vendor
HTTP to HTTPS Port (nginx)
Nginx：向 HTTPS 端口发送明文 HTTP
499
vendor
Client Closed Request (nginx)
客户端在响应完成前关闭连接
500
5xx
Internal Server Error
服务器内部错误
501
5xx
Not Implemented
不支持该方法或能力
502
5xx
Bad Gateway
网关从上游收到无效响应
503
5xx
Service Unavailable
过载或维护，暂不可用
504
5xx
Gateway Timeout
网关等待上游超时
505
5xx
HTTP Version Not Supported
不支持请求中的 HTTP 版本
506
5xx
Variant Also Negotiates
透明协商配置错误
507
5xx
Insufficient Storage
存储空间不足（WebDAV）
508
5xx
Loop Detected
检测到循环（WebDAV）
510
5xx
Not Extended
需扩展（RFC 2774 实验状态，IANA 标为 OBSOLETED，可忽略）
511
5xx
Network Authentication Required
需在网络层认证（如强制门户）
520
vendor
Unknown Error (Cloudflare)
源站返回异常或空响应
521
vendor
Web Server Is Down (Cloudflare)
无法与源站建立 TCP
522
vendor
Connection Timed Out (Cloudflare)
与源站握手或连接超时
523
vendor
Origin Is Unreachable (Cloudflare)
无法路由到源站
524
vendor
A Timeout Occurred (Cloudflare)
源站已连接但未及时返回完整响应
525
vendor
SSL Handshake Failed (Cloudflare)
与源站 SSL 握手失败
526
vendor
Invalid SSL Certificate (Cloudflare)
源站证书无效
527
vendor
Railgun Error (Cloudflare)
Railgun 边缘到源监听错误（Cloudflare 专用）

Eina de referència gratuïta per a codis d'estat HTTP, cobreix completament les 5 categories: 1xx informatius/2xx èxit/3xx redirecció/4xx error client/5xx error servidor, amb extensions de proveïdors. Admet filtratge per categories i cerca per paraules clau. Essencial per al desenvolupament i depuració.

Relacionats

Verificador de Capçaleres de Seguretat

Verificador de Certificats SSL

Verificador de Capçaleres HTTP

Generador de Capçaleres CORS

Comprovador de cadena de reorientació

Casos d'ús

  • Depuració Web/API: quan hi hagi errors d'API, consulta ràpidament el significat dels codis d'estat per determinar la direcció del problema (paràmetres frontend o bug backend?)
  • Resolució de problemes d'integració d'API: distingeix entre fallida d'autenticació 401, permisos insuficients 403, adreça no trobada 404, error intern del servidor 500
  • Diagnòstic de fallides operatives: quan es trobin errors 502/503/504/522/524, identifica ràpidament la causa i la solució
  • Treballs de SEO: comprova si el tipus de redirecció 301/302 és correcte, comprova si la gestió de la pàgina d'error 404 és adequada
  • Aprenentatge del protocol HTTP: els principiants aprenen de manera sistemàtica les categories de codis HTTP i el propòsit de cada codi
  • Preparació per a entrevistes: les entrevistes frontend/backend solen preguntar sobre la diferència entre 301 vs 302, 401 vs 403, 502 vs 504
  • Anàlisi de registres: entén el significat de cada codi d'estat en analitzar els registres d'accés de Nginx/Apache/CDN

Característiques

  • Cobertura completa: tots els codis estàndard 1xx-5xx + extensions de proveïdors Cloudflare/Nginx (5xx vendor) en un sol lloc
  • Targetes d'accés ràpid: els 12 codis més utilitzats (200/301/302/304/400/401/403/404/429/500/502/503) — fes clic a la targeta per veure els detalls directament
  • Filtre per categories: filtratge amb un sol clic per categoria 1xx/2xx/3xx/4xx/5xx/vendor per identificar ràpidament el tipus de problema
  • Cerca per paraules clau: admet cerca difusa per número de codi, nom en anglès o descripció per trobar ràpidament el codi objectiu
  • Codificació per colors: 2xx verd (èxit), 3xx/4xx groc (avís/problema de client), 5xx vermell (problema de servidor) per a una avaluació visual fàcil
  • Taula a escriptori/targetes a mòbil: taula completa a escriptori, targetes responsives a mòbil per a una experiència excel·lent en tots els dispositius
  • Còpia de resum filtrat amb un sol clic: copia les condicions de filtre actuals i el recompte de resultats per a tiquets/documentació

Com usar-ho

  1. Simplement escriu el número de codi d'estat (ex. 404) o paraules clau (ex. redirect, forbidden, timeout) al quadre de cerca
  2. O fes clic als botons de categoria (1xx/2xx/3xx/4xx/5xx/vendor) per navegar per categoria
  3. Fes clic a la targeta de codi habitual per filtrar ràpidament aquest codi
  4. Consulta el nom del codi d'estat, el color de la categoria i la descripció detallada
  5. Fes clic al botó de còpia per copiar el resum filtrat actual per als tiquets de problemes

Preguntes freqients

Què són els codis d'estat HTTP i per a què serveixen?

Els codis d'estat HTTP són codis numèrics de tres dígits que el servidor retorna en resposta a una sol·licitud HTTP, indicant si la sol·licitud ha tingut èxit, ha fallat o requereix accions addicionals. Es divideixen en 5 categories: 1xx informatius, 2xx èxit, 3xx redirecció, 4xx error de client, 5xx error de servidor. Durant el desenvolupament i la depuració, els codis d'estat poden indicar ràpidament la direcció del problema: 2xx indica èxit, no cal cap acció; 4xx indica comprovar paràmetres de la sol·licitud/autenticació/permisos/límit de taxa; 5xx indica comprovar els registres del servidor.

Quina és la diferència real entre la redirecció 301 i 302?

La diferència clau: 301 és una **redirecció permanent** — els navegadors/motors de cerca cachegen la nova adreça i el poder SEO es transfereix a la nova URL; 302 és una **redirecció temporal** — no es cacheja, no hi ha transferència de poder. També hi ha una diferència important en el canvi de mètode: històricament 301/302 canviaven POST a GET (comportament incorrecte), mentre que 307/308 mantenen estrictament el mètode de sol·licitud original. Utilitza 301 per a redireccions HTTPS, migracions de domini, canvis permanents d'URL; utilitza 302 o 307 per a manteniment temporal i pàgines de campanya.

Quina diferència hi ha entre 401 i 403?

401 Unauthorized significa 'no autenticat' — el servidor no sap qui ets, has d'iniciar sessió/proporcionar Token primer (generalment amb la capçalera WWW-Authenticate); 403 Forbidden significa 'autenticat però sense permís' — el servidor sap qui ets, però no tens permís per accedir a aquest recurs. En poques paraules: 401 és 'no portes la targeta', 403 és 'tens la targeta però no pots entrar a aquesta sala'.

Quina diferència hi ha entre 502, 503 i 504?

Tots són errors de servidor però per causes diferents: 502 Bad Gateway significa que el reverse proxy ha rebut una **resposta invàlida** d'upstream (backend fallat/error de protocol); 503 Service Unavailable significa que el servidor està **temporalment indisponible** (sobrecarregat/manteniment/servei no iniciat); 504 Gateway Timeout significa que el servidor proxy ha **superat el temps d'espera per upstream** (processament backend massa lent/consulta a base de dades lenta). Per resoldre problemes: per a 502, comprova si el procés backend s'executa i els registres d'errors; per a 503, comprova l'estat del servei/límit de taxa/pàgina de manteniment; per a 504, comprova el rendiment del backend/consultes lentes/configuració de timeout.

Quan utilitzar 200 OK vs 204 No Content?

200 OK és la resposta d'èxit estàndard i pot retornar un cos de resposta (ex. resultats de consulta, dades de recurs creat); 204 No Content indica èxit però **no retorna cap cos de resposta**, s'utilitza habitualment per a DELETE reeixit, actualitzacions PUT/POST reeixides on no cal retornar dades. Les respostes 204 no haurien de tenir cos.

Com gestionar el codi de límit de taxa 429?

429 Too Many Requests significa que el client ha superat el límit de freqüència de sol·licituds del servidor. La resposta generalment inclou la capçalera Retry-After que indica quants segons esperar abans de tornar-ho a provar. El client hauria d'utilitzar backoff exponencial (Exponential Backoff): esperar 1 segon el primer cop, 2 el segon, 4 el tercer... A més, comprova les capçaleres X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset per conèixer la quota de límit de taxa.

Què són els codis d'extensió de proveïdors com els 520-527 de Cloudflare?

Els codis d'estat HTTP estàndard només es defineixen en el rang 100-599, la majoria registrats a IANA, però els proveïdors de CDN/proxy defineixen extensions personalitzades: Cloudflare defineix la sèrie 520-527 per a problemes de connexió amb l'origen (521 origen rebutja, 522 timeout de connexió, 524 timeout de resposta, etc.); Nginx defineix el 499 (client tanca la connexió). Aquests codis no són codis HTTP estàndard però apareixen sovint en la resolució de problemes operatius reals, i aquesta eina inclou codis d'extensió de proveïdors habituals.

Què són els codis d'estat HTTP?

Els codis d'estat HTTP (HTTP Status Code) són codis numèrics de tres dígits que el servidor retorna en respondre a una sol·licitud HTTP, indicant el resultat del processament — èxit o fracàs? Si ha fallat, és culpa del client o del servidor? Cal redirecció? Aquesta és una de les informacions diagnòstiques més bàsiques i importants en el desenvolupament i operació web.

Els codis d'estat es divideixen en 5 categories segons el primer dígit: **1xx Respostes informatives** (sol·licitud rebuda, procés continu, poc freqüent a la pràctica); **2xx Èxit** (sol·licitud processada amb èxit, el més comú és 200 OK); **3xx Redirecció** (cal acció addicional del client, com 301 redirecció permanent, 302 redirecció temporal, 304 hit de caché); **4xx Error de client** (problemes amb la sol·licitud, com 400 paràmetres invàlids, 401 no autenticat, 403 sense permís, 404 no trobat, 429 límit de taxa); **5xx Error de servidor** (el servidor no ha pogut processar la sol·licitud, com 500 error intern, 502 Bad Gateway, 503 indisponible, 504 timeout).

**Per què distingir entre 4xx i 5xx?** Aquesta és la primera avaluació de prioritat en resoldre problemes: quan veus 4xx, primer has de comprovar la teva sol·licitud — l'URL és correcta? els paràmetres són complets? s'ha adjuntat el Token? els permisos són suficients? les sol·licituds són massa freqüents?; quan veus 5xx, cal comprovar els registres del servidor — el procés backend s'executa normalment? la base de dades està connectada? la configuració és correcta? hi ha sobrecàrrega?. Anar en la direcció equivocada perdrà molt de temps de depuració.

**La diferència entre codis de redirecció és un tema d'examen comú**: 301 és redirecció permanent (transferència de poder SEO, caché del navegador), 302 és redirecció temporal (sense transferència de poder), 307/308 mantenen estrictament el mètode de sol·licitud (POST no es convertirà en GET). A la pràctica utilitza 301 per a redireccions HTTPS i migracions de domini, 302 per a manteniment temporal, 303 per a redireccions després d'enviar formularis POST (patró PRG).

Aquesta eina **cobreix completament** tots els codis d'estat HTTP estàndard (inclosos els codis fàcils de confondre com 303/307/308, 405/409/422/429, etc.), així com codis d'extensió de proveïdors habituals de Cloudflare/Nginx (520-527, 499). Admet filtratge per categories, cerca per paraules clau i targetes d'accés ràpid — una eina de referència diària essencial per a la depuració de desenvolupament, la resolució de problemes d'API i la localització de fallides operatives.

术语表

HTTP
HyperText Transfer Protocol, el protocol base per a la comunicació de dades a la World Wide Web, basat en TCP/IP, utilitza un model sol·licitud-resposta. Les versions principals actuals són HTTP/1.1 i HTTP/2, HTTP/3 es basa en QUIC.
Idempotency (Idempotència)
Executar la mateixa sol·licitud diverses vegades té el mateix efecte que executar-la una vegada. GET/HEAD/PUT/DELETE/OPTIONS/TRACE són idempotents; POST no és idempotent (enviaments múltiples creen múltiples recursos). Aquesta és la raó clau per la qual 307/308 mantenen el mètode: preservar la idempotència.
CORS (Cross-Origin Resource Sharing)
Mecanisme per a l'accés entre orígens sota la política same-origin del navegador. Les sol·licituds CORS preflight (OPTIONS) poden retornar 405 Method Not Allowed o errors relacionats amb CORS, que és un dels problemes més habituals en el desenvolupament frontend.
Patró PRG (Post/Redirect/Get)
Millor pràctica per a l'enviament de formularis web: després d'enviar un formulari amb POST, retorna una redirecció 303 See Other a la pàgina de resultats, per evitar enviaments duplicats quan l'usuari refresca. Aquest és el cas d'ús més comú del 303.
Retry-After
Capçalera de resposta HTTP, utilitzada amb 503 Service Unavailable o 429 Too Many Requests, indica al client quants segons ha d'esperar abans de tornar a provar la sol·licitud.
WWW-Authenticate
Capçalera de resposta HTTP, utilitzada amb 401 Unauthorized, indica al client quin esquema d'autenticació utilitzar (Basic/Bearer/Digest, etc.) i l'àmbit d'autenticació.
ETag / If-None-Match
Mecanisme de validació de caché. El servidor retorna un ETag que identifica la versió del recurs; en sol·licituds posteriors el client envia la capçalera If-None-Match, i si el recurs no ha canviat, el servidor retorna 304 Not Modified (sense cos, estalviant amplada de banda).
Reverse Proxy
Servidor intermediari (com Nginx, Cloudflare, HAProxy) situat entre el client i el servidor backend, rep sol·licituds del client i les reenvia al backend, després retorna la resposta del backend al client. Els errors 502/503/504 es produeixen entre el reverse proxy i el backend.

Visió general de les 5 categories de codis d'estat HTTP

ClasseSignificatPropòsitCodis habituals
1xxResposta informativa (Informational)S'ha rebut la sol·licitud, continua el procés (estat intermedi del protocol)100 Continue, 101 Switching Protocols
2xxResposta d'èxit (Success)El servidor ha rebut, entès i acceptat la sol·licitud amb èxit200 OK, 201 Created, 204 No Content, 206 Partial Content
3xxRedirecció (Redirection)Cal una acció addicional del client per completar la sol·licitud301 Moved Permanently, 302 Found, 304 Not Modified, 307/308
4xxError de client (Client Error)La sol·licitud conté errors de sintaxi o no es pot processar, culpa del client400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests
5xxError de servidor (Server Error)El servidor no ha pogut processar una sol·licitud que sembla vàlida, culpa del servidor500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable, 504 Gateway Timeout

Comparació de codis de redirecció habituals (301/302/303/307/308)

CodiNomPermanentCanvi de mètodeCachejableCas d'ús habitual
301Moved Permanently✅ PermanentPOST pot convertir-se en GET (compatibilitat històrica)✅ Cache per defecteRedisseny web, migració de domini, HTTP→HTTPS, URLs antigues obsoletes
302Found❌ TemporalPOST pot convertir-se en GET (compatibilitat històrica)❌ No cache per defecteRedirecció temporal per manteniment, pàgines de campanya, proves A/B
303See Other❌ TemporalPOST→GET (canvi explícit)❌ No cache per defecteRedirecció a la pàgina de resultats després d'enviar un formulari POST (patró PRG)
307Temporary Redirect❌ TemporalManté estrictament el mètode original❌ No cache per defecteRedirecció temporal que manté estrictament el mètode i el cos de la sol·licitud
308Permanent Redirect✅ PermanentManté estrictament el mètode original✅ Cache per defecteRedirecció permanent que evita que POST es converteixi en GET

Guia de resolució de problemes per a errors de client habituals

CodiSignificatCauses habitualsEnfocament de solució
400Bad RequestError de sintaxi de la sol·licitud/paràmetres absents/error de format JSON/capçaleres massa gransComprova els paràmetres de la sol·licitud, Content-Type, codificació URL
401UnauthorizedNo autenticat/Token expirat/capçalera Authorization absentComprova l'estat d'inici de sessió, l'expiració del Token, el format de la capçalera Bearer
403ForbiddenAutenticat però sense permís/IP bloquejada/CSRF Token invàlid/WAF bloquejatComprova els permisos d'usuari, la llista blanca d'IP, les regles WAF, el CSRF Token
404Not FoundL'URL no existeix/recurs eliminat/error de configuració d'enrutamentComprova l'ortografia de l'URL, la configuració de rutes, si el recurs ha estat eliminat
405Method Not AllowedMètode de sol·licitud no permès (ex. utilitzar POST en un endpoint que només accepta GET)Comprova el mètode HTTP (GET/POST/PUT/DELETE, etc.), CORS preflight
408Request TimeoutEl client envia la sol·licitud massa lentament/latència de xarxa/timeout del servidor massa curtComprova la connexió de xarxa, augmenta el timeout, càrrega fragmentada
409ConflictConflicte de recursos (ex. creació duplicada, conflicte de versió, edició concurrent)Comprova enviaments duplicats, utilitza bloqueig optimista/clau d'idempotència
413Payload Too LargeEl fitxer carregat/el cos de la sol·licitud supera el límit del servidorComprova client_max_body_size d'nginx, comprimeix fitxers, càrrega fragmentada
422Unprocessable EntityEl format de la sol·licitud és correcte però hi ha errors semàntics (ex. validació de camps fallida)Comprova la validació de paràmetres de l'API RESTful: camps requerits, tipus de dades, format
429Too Many RequestsS'ha superat el límit de taxa/la freqüència de sol·licituds és massa altaRedueix la freqüència de sol·licituds, afegeix backoff exponencial, demana una quota més alta

Errors de servidor habituals i codis d'extensió de Cloudflare

CodiSignificatCauses habituals
500Internal Server ErrorExcepció en el codi del servidor/error no gestionat/error de connexió a base de dades/error de configuració
501Not ImplementedEl servidor no admet la funcionalitat sol·licitada (ex. mètode HTTP no suportat)
502Bad GatewayEl reverse proxy (nginx/CDN) ha rebut una resposta invàlida d'upstream/el procés backend ha fallat/PHP-FPM no s'executa
503Service UnavailableServidor sobrecarregat/en manteniment/servei backend no iniciat/pool de connexions esgotat
504Gateway TimeoutEl reverse proxy ha superat el temps d'espera per la resposta d'upstream/processament backend massa lent/consulta a base de dades lenta
520Web Server Returned Unknown Error (CF)Cloudflare: l'origen ha retornat una resposta desconeguda/anòmala (error de protocol/resposta buida/sense codi d'estat)
521Web Server Is Down (CF)Cloudflare: el servidor d'origen ha rebutjat la connexió (origen fora de línia/firewall bloqueja IP de CF)
522Connection Timed Out (CF)Cloudflare: no s'ha pogut establir una connexió TCP amb l'origen (firewall d'origen/grup de seguretat/iptables)
523Origin Is Unreachable (CF)Cloudflare: la IP d'origen no és accessible (servidor d'origen inexistent/problema d'enrutament)
524A Timeout Occurred (CF)Cloudflare: la connexió TCP ha tingut èxit però l'origen ha superat el temps per retornar la resposta HTTP (>100s). Comú en consultes lentes/ tasques de llarga durada
499Client Closed Request (Nginx)Codi d'extensió Nginx: el client ha tancat la connexió abans que el servidor respongués (usuari cancel·la/timeout frontend)

Authoritative References