Wyszukiwarka kodów statusu HTTP

O GeekFormat

Kody Statusu o Wysokiej Częstotliwości

Wyniki wyszukiwania (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

请求成功

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 专用）

Kod	Grupa	Nazwa	Opis
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 专用）

Darmowy słownik kodów statusu HTTP z pełnym pokryciem 5 kategorii: 1xx Informacyjne/2xx Sukces/3xx Przekierowanie/4xx Błąd klienta/5xx Błąd serwera, plus rozszerzenia dostawców. Obsługuje filtrowanie po kategoriach i wyszukiwanie po słowach kluczowych, niezbędne do rozwoju i debugowania.

Powiązane Rekomendacje

Sprawdzanie nagłówków bezpieczeństwa

Sprawdzanie Certyfikatów SSL

Sprawdzanie nagłówków HTTP

Generator nagłówków CORS

Sprawdzanie przekierowań

Co to są kody statusu HTTP?

Kody statusu HTTP (HTTP Status Code) to trzycyfrowe kody numeryczne zwracane przez serwery podczas odpowiadania na żądania HTTP, wskazujące wynik przetwarzania — powiodło się czy nie powiodło? W przypadku błędu to był problem klienta czy serwera? Czy wymagane jest przekierowanie? To jedna z najbardziej podstawowych i ważnych informacji diagnostycznych w rozwoju i operacjach webowych.

Kody statusu są podzielone na 5 kategorii według pierwszej cyfry: **1xx Odpowiedź informacyjna** (żądanie odebrane, przetwarzanie trwa, rzadko w praktyce); **2xx Sukces** (żądanie pomyślnie przetworzone, najczęstszy to 200 OK); **3xx Przekierowanie** (wymagana dodatkowa akcja klienta, np: 301 stałe przekierowanie, 302 tymczasowe przekierowanie, 304 trafienie w pamięć podręczną); **4xx Błąd klienta** (problem z żądaniem, np: 400 nieprawidłowe parametry, 401 nie uwierzytelniono, 403 brak uprawnień, 404 nie znaleziono, 429 limit szybkości); **5xx Błąd serwera** (serwer nie przetworzył żądania, np: 500 błąd wewnętrzny, 502 Bad Gateway, 503 niedostępny, 504 timeout).

**Dlaczego rozróżniać 4xx i 5xx?** To ocena pierwszego priorytetu przy rozwiązywaniu problemów: gdy widzisz 4xx najpierw sprawdź własne żądanie — czy URL jest poprawny, parametry kompletne, Token dołączony, uprawnienia wystarczające, żądania nie są zbyt częste?; gdy widzisz 5xx musisz sprawdzić logi serwera — czy procesy backendu działają, baza danych jest połączona, konfiguracja poprawna, jest przeciążenie?. Pójście w złym kierunku marnuje dużo czasu debugowania.

**Różnice między kodami przekierowań to częsty temat egzaminów**: 301 to stałe przekierowanie (transfer autorytetu SEO, pamięć podręczna przeglądarki), 302 to tymczasowe przekierowanie (bez transferu autorytetu), 307/308 ściśle zachowują metodę żądania (POST nie jest konwertowany na GET). W praktyce używaj 301 do przekierowań HTTPS i migracji domen, 302 do tymczasowej konserwacji, 303 do przekierowań po wysłaniu formularzy POST (wzorzec PRG).

To narzędzie **pełnie zawiera** wszystkie standardowe kody statusu HTTP (w tym te łatwe do pomylenia jak 303/307/308, 405/409/422/429 itp.) oraz powszechnie używane kody rozszerzeń dostawców od Cloudflare/Nginx (520-527, 499). Obsługuje filtrowanie po kategoriach, wyszukiwanie po słowach kluczowych i karty szybkiego dostępu — niezbędne codzienne narzędzie referencyjne do debugowania rozwoju, rozwiązywania problemów API i lokalizowania awarii operacyjnych.

Przypadki użycia

Debugowanie Web/API: Gdy API mają błędy, szybko wyszukuj znaczenie kodów statusu aby określić kierunek rozwiązania (parametry frontendu czy błąd backendu?)
Rozwiązywanie problemów integracji API: Rozróżniaj niepowodzenie uwierzytelniania 401, niewystarczające uprawnienia 403, nieprawidłowy adres 404, błąd serwera 500
Diagnostyka awarii operacyjnych: Gdy napotkasz błędy 502/503/504/522/524 szybko zlokalizuj przyczyny i rozwiązania
Praca SEO: Sprawdzaj czy typy przekierowań 301/302 są poprawne, sprawdzaj czy obsługa stron błędów 404 jest odpowiednia
Nauka protokołu HTTP: Początkujący systematycznie uczą się kategorii kodów HTTP i przeznaczenia każdego kodu
Przygotowanie do rozmów kwalifikacyjnych: Rozmowy frontend/backend często pytają o różnice 301 vs 302, 401 vs 403, 502 vs 504
Analiza logów: Zrozum znaczenie każdego kodu statusu podczas analizy logów dostępu Nginx/Apache/CDN

Jak Używać

Po prostu wpisz numer kodu statusu (np: 404) lub słowo kluczowe (np: redirect, forbidden, timeout) w polu wyszukiwania
Lub kliknij przyciski kategorii (1xx/2xx/3xx/4xx/5xx/vendor) aby nawigować po kategoriach
Kliknij karty częstych kodów aby szybko filtrować po tym kodzie
Przeglądaj nazwę kodu statusu, kolor kategorii i szczegółowy opis
Kliknij przycisk kopiowania aby skopiować aktualne podsumowanie filtra do rejestracji problemów

Funkcje

Pełne pokrycie: Standardowe kody 1xx-5xx + rozszerzenia dostawców Cloudflare/Nginx (5xx vendor), wszystko w jednym miejscu
Karty szybkiego dostępu: 12 najczęściej używanych kodów (200/301/302/304/400/401/403/404/429/500/502/503) — kliknij karty aby zobaczyć szczegóły
Filtr po kategoriach: Filtrowanie jednym kliknięciem po kategoriach 1xx/2xx/3xx/4xx/5xx/vendor aby szybko zlokalizować typy problemów
Wyszukiwanie po słowach kluczowych: Obsługa wyszukiwania rozmytego po numerze kodu, angielskiej nazwie lub opisie aby szybko znaleźć docelowy kod
Kodowanie kolorami: 2xx zielony (sukces), 3xx/4xx żółty (uwaga/problemy klienta), 5xx czerwony (problemy serwera) dla intuicyjnej oceny wizualnej
Tabela na desktopie/karty na mobile: Pełny widok tabeli na desktopie, responsywne karty na mobile dla doskonałego doświadczenia na wszystkich urządzeniach
Kopiowanie podsumowania filtra jednym kliknięciem: Kopiuj aktualne warunki filtra i liczbę wyników do zgłoszeń/dokumentacji

Często Zadawane Pytania

Co to są kody statusu HTTP i do czego służą?

Kody statusu HTTP to trzycyfrowe kody numeryczne zwracane przez serwery w odpowiedzi na żądania HTTP, wskazujące czy żądanie się powiodło, nie powiodło lub wymaga dodatkowej akcji. Są podzielone na 5 kategorii: 1xx Informacyjne, 2xx Sukces, 3xx Przekierowanie, 4xx Błąd klienta, 5xx Błąd serwera. Podczas rozwoju i debugowania kody statusu szybko wskazują kierunek problemu: 2xx sukces bez akcji; 4xx sprawdź parametry żądania/uwierzytelnianie/uprawnienia/limity szybkości; 5xx sprawdź logi serwera.

Jaka jest dokładna różnica między przekierowaniami 301 i 302?

Kluczowa różnica: 301 to **stałe przekierowanie** — przeglądarki/wyszukiwarki buforują nowy adres i autorytet SEO jest przenoszony na nowy URL; 302 to **tymczasowe przekierowanie** — nie jest buforowane i nie ma transferu autorytetu. Jest też ważna różnica w zmianie metody: historycznie 301/302 zmieniały POST na GET (nieprecyzyjne zachowanie), podczas gdy 307/308 ściśle zachowują oryginalną metodę żądania. Używaj 301 do przekierowań HTTPS, migracji domen, stałych zmian URL; używaj 302 lub 307 do tymczasowej konserwacji i stron kampanii.

Jaka jest różnica między 401 i 403?

401 Unauthorized oznacza 'nie uwierzytelniono' — serwer nie wie kim jesteś, musisz się najpierw zalogować/dostarczyć Token (zwykle z nagłówkiem WWW-Authenticate); 403 Forbidden oznacza 'uwierzytelniono ale brak uprawnień' — serwer wie kim jesteś, ale nie masz uprawnień do tego zasobu. Mówiąc prościej: 401 to 'nie masz przepustki', 403 to 'masz przepustkę ale nie możesz wejść do tego pokoju'.

Jaka jest różnica między 502, 503 i 504?

Wszystkie to błędy serwera ale z różnymi przyczynami: 502 Bad Gateway oznacza że reverse proxy otrzymał **nieprawidłową odpowiedź** od upstream (backend uległ awarii/błąd protokołu); 503 Service Unavailable oznacza że serwer jest **tymczasowo niedostępny** (przeciążenie/konserwacja/usługa nie uruchomiona); 504 Gateway Timeout oznacza że serwer proxy **dostał timeout czekając na upstream** (backend przetwarza zbyt wolno/wolne zapytania BD). Podczas rozwiązywania problemów: dla 502 sprawdź czy procesy backendu działają i logi błędów; dla 503 sprawdź stan usługi/limity szybkości/strony konserwacji; dla 504 sprawdź wydajność backendu/wolne zapytania/konfigurację timeout.

Kiedy używać 200 OK vs 204 No Content?

200 OK to standardowa odpowiedź sukcesu i może zwracać treść odpowiedzi (np: wyniki zapytania, dane utworzonego zasobu); 204 No Content oznacza sukces ale **nie zwraca treści odpowiedzi**, powszechnie używane dla pomyślnego DELETE, pomyślnych aktualizacji PUT/POST gdzie dane nie muszą być zwracane. Odpowiedź 204 nie powinna zawierać treści.

Jak obsługiwać kod limitu szybkości 429?

429 Too Many Requests oznacza że klient przekroczył limit częstotliwości żądań serwera. Odpowiedź zwykle zawiera nagłówek Retry-After wskazujący ile sekund czekać przed ponowną próbą. Klienci powinni implementować wykładniczy backoff (Exponential Backoff): czekaj 1 sekundę przy pierwszej próbie, 2 przy drugiej, 4 przy trzeciej... Sprawdź też nagłówki X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset aby poznać quoty limitów szybkości.

Co to są kody rozszerzeń dostawców, jak 520-527 od Cloudflare?

Standardowe kody statusu HTTP są zdefiniowane tylko w zakresie 100-599 i większość jest zarejestrowana w IANA, ale dostawcy CDN/proxy definiują niestandardowe rozszerzenia: Cloudflare definiuje serię 520-527 dla problemów z połączeniem ze źródłem (521 źródło odmówiło, 522 timeout połączenia, 524 timeout odpowiedzi itp.); Nginx definiuje 499 (klient zamknął połączenie). Te kody nie są standardowymi kodami HTTP ale często pojawiają się w rzeczywistej diagnostyce operacyjnej, a to narzędzie zawiera powszechnie używane kody rozszerzeń dostawców.

Słownik

HTTP: HyperText Transfer Protocol, podstawowy protokół komunikacji danych w sieci World Wide Web, oparty na TCP/IP, używający modelu żądanie-odpowiedź. Obecne główne wersje to HTTP/1.1 i HTTP/2, z HTTP/3 opartym na QUIC.
Idempotencja (Idempotence): Wykonanie tego samego żądania wielokrotnie ma ten sam efekt co wykonanie go raz. GET/HEAD/PUT/DELETE/OPTIONS/TRACE są idempotentne; POST nie jest idempotentny (wielokrotne wysłania tworzą wielokrotne zasoby). Ważny powód dla którego 307/308 zachowują metodę to utrzymanie idempotencji.
CORS (Cross-Origin Resource Sharing): Mechanizm dostępu cross-origin w ramach polityki same-origin przeglądarki. Żądania preflight CORS (OPTIONS) mogą zwracać 405 Method Not Allowed lub błędy związane z CORS, jeden z najczęstszych problemów w rozwoju frontendu.
Wzorzec PRG (Post/Redirect/Get): Najlepsza praktyka wysyłania formularzy webowych: Po wysłaniu formularza metodą POST zwróć przekierowanie 303 See Other do strony wyników, unikając powtórzonych wysłań gdy użytkownik odświeży stronę. To najbardziej typowy przypadek użycia 303.
Retry-After: Nagłówek odpowiedzi HTTP używany z 503 Service Unavailable lub 429 Too Many Requests aby poinformować klienty ile sekund czekać przed ponownym żądaniem.
WWW-Authenticate: Nagłówek odpowiedzi HTTP używany z 401 Unauthorized aby poinformować klienty jakiego schematu uwierzytelniania użyć (Basic/Bearer/Digest itp.) i zakres uwierzytelniania.
ETag / If-None-Match: Mechanizm walidacji pamięci podręcznej. Serwer zwraca ETag identyfikujący wersję zasobu; klienty wysyłają nagłówek If-None-Match w kolejnych żądaniach, a jeśli zasób się nie zmienił serwer zwraca 304 Not Modified (bez treści, oszczędzając pasmo).
Reverse Proxy: Serwer proxy (jak Nginx, Cloudflare, HAProxy) umieszczony między klientami a serwerami backendu, odbierający żądania od klientów i przekazujący je do backendów, a następnie zwracający odpowiedzi od backendów do klientów. Błędy 502/503/504 występują wszystkie między reverse proxy a backendem.

Przegląd 5 kategorii kodów statusu HTTP

Klasa	Znaczenie	Cel	Częste kody
`1xx`	Odpowiedź informacyjna (Informational)	Żądanie odebrane, przetwarzanie trwa (stan pośredni protokołu)	100 Continue, 101 Switching Protocols
`2xx`	Odpowiedź sukcesu (Success)	Żądanie zostało pomyślnie odebrane, zrozumiane i zaakceptowane przez serwer	200 OK, 201 Created, 204 No Content, 206 Partial Content
`3xx`	Przekierowanie (Redirection)	Wymagana dodatkowa akcja klienta do ukończenia żądania	301 Moved Permanently, 302 Found, 304 Not Modified, 307/308
`4xx`	Błąd klienta (Client Error)	Żądanie zawiera błąd składni lub nie może być spełnione, wina klienta	400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests
`5xx`	Błąd serwera (Server Error)	Serwer nie spełnił pozornie ważnego żądania, wina serwera	500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable, 504 Gateway Timeout

Porównanie częstych kodów przekierowań (301/302/303/307/308)

Kod	Nazwa	Stały	Zmiana metody	Buforowalny	Typowy przypadek użycia
`301`	Moved Permanently	✅ Stały	POST może stać się GET (kompatybilność historyczna)	✅ Domyślnie buforowany	Redesign strony, migracja domeny, HTTP→HTTPS, przestarzałe URL
`302`	Found	❌ Tymczasowy	POST może stać się GET (kompatybilność historyczna)	❌ Domyślnie nie buforowany	Tymczasowe przekierowanie konserwacyjne, strony kampanii, testy A/B
`303`	See Other	❌ Tymczasowy	POST→GET (jawna zmiana)	❌ Domyślnie nie buforowany	Przekierowanie do strony wyników po wysłaniu formularza POST (wzorzec PRG)
`307`	Temporary Redirect	❌ Tymczasowy	Ściśle zachowuje oryginalną metodę	❌ Domyślnie nie buforowany	Tymczasowe przekierowanie ściśle zachowujące metodę i treść żądania
`308`	Permanent Redirect	✅ Stały	Ściśle zachowuje oryginalną metodę	✅ Domyślnie buforowany	Stałe przekierowanie zapobiegające konwersji POST na GET

Przewodnik rozwiązywania częstych błędów klienta

Kod	Znaczenie	Częste przyczyny	Kierunek rozwiązania
`400`	Bad Request	Błąd składni żądania/brakujące parametry/błąd formatu JSON/za duże nagłówki	Sprawdź parametry żądania, Content-Type, kodowanie URL
`401`	Unauthorized	Nie uwierzytelniono/Token wygasł/brak nagłówka Authorization	Sprawdź stan logowania, wygaśnięcie Tokenu, format nagłówka Bearer
`403`	Forbidden	Uwierzytelniono ale brak uprawnień/IP zablokowany/Token CSRF nieprawidłowy/WAF zablokował	Sprawdź uprawnienia użytkownika, białą listę IP, reguły WAF, CSRF Token
`404`	Not Found	URL nie istnieje/zasób usunięty/błąd konfiguracji routingu	Sprawdź pisownię URL, konfigurację tras, czy zasób został usunięty
`405`	Method Not Allowed	Nieprawidłowa metoda żądania (np: użycie POST na endpointcie akceptującym tylko GET)	Sprawdź metody HTTP (GET/POST/PUT/DELETE itp.), CORS preflight
`408`	Request Timeout	Klient wysyła żądanie zbyt wolno/opóźnienie sieci/za krótki timeout serwera	Sprawdź połączenie sieciowe, zwiększ timeout, wysyłaj partiami
`409`	Conflict	Konflikt zasobów (np: duplikat utworzenia, konflikt wersji, równoczesna modyfikacja)	Sprawdź powtórzone wysłania, użyj blokowania optymistycznego/kluczy idempotencji
`413`	Payload Too Large	Przesyłany plik/treść żądania przekracza limit serwera	Sprawdź client_max_body_size nginx, kompresuj pliki, fragmentowane wysyłanie
`422`	Unprocessable Entity	Format żądania poprawny ale błąd semantyczny (np: niepowodzenie walidacji pól)	Walidacja parametrów RESTful API, sprawdź pola wymagane, typy danych, formaty
`429`	Too Many Requests	Przekroczono limit szybkości/zbyt wysoka częstotliwość żądań	Zmniejsz częstotliwość żądań, dodaj wykładniczy backoff, poproś o większy limit

Częste błędy serwera i kody rozszerzeń Cloudflare

Kod	Znaczenie	Częste przyczyny
`500`	Internal Server Error	Wyjątek w kodzie serwera/nieprzechwycony błąd/niepowodzenie połączenia z BD/błąd konfiguracji
`501`	Not Implemented	Serwer nie obsługuje żądanej funkcjonalności (np: nieobsługiwana metoda HTTP)
`502`	Bad Gateway	Reverse proxy (nginx/CDN) otrzymał nieprawidłową odpowiedź od upstream/proces backendu uległ awarii/PHP-FPM nie uruchomiony
`503`	Service Unavailable	Serwer przeciążony/w konserwacji/usługa backendu nie uruchomiona/pula połączeń wyczerpana
`504`	Gateway Timeout	Reverse proxy dostał timeout czekając na odpowiedź od upstream/backend przetwarza zbyt wolno/wolne zapytania BD
`520`	Web Server Returned Unknown Error (CF)	Cloudflare: Źródło zwróciło nieznaną/anormalną odpowiedź (błąd protokołu/pusta odpowiedź/bez kodu statusu)
`521`	Web Server Is Down (CF)	Cloudflare: Serwer źródłowy odmówił połączenia (źródło offline/firewall blokuje IP CF)
`522`	Connection Timed Out (CF)	Cloudflare: Nie można nawiązać połączenia TCP ze źródłem (firewall źródła/security group/iptables)
`523`	Origin Is Unreachable (CF)	Cloudflare: IP źródła nieosiągalne (serwer źródłowy nie istnieje/problemy routingu)
`524`	A Timeout Occurred (CF)	Cloudflare: Połączenie TCP udane ale źródło dostał timeout zwracając odpowiedź HTTP (>100s), częste przy wolnych zapytaniach/długich zadaniach
`499`	Client Closed Request (Nginx)	Kod rozszerzenia Nginx: Klient zamknął połączenie zanim serwer odpowiedział (użytkownik anulował/timeout frontendu)

Authoritative References

ReferenceMDN - Kody statusu odpowiedzi HTTP
ReferenceRFC 9110 - Standard semantyki HTTP
ReferenceWikipedia - Kody statusu HTTP
ReferenceRozwiązywanie błędów Cloudflare 5xx