Semua penyebab kami nyalakan dulu di lab: nginx 1.26.3, PHP-FPM 8.4.27, Debian 13, 16 November 2026. Setiap perbaikan diuji ulang sampai request yang sama lolos.
Nginx hampir tidak pernah menciptakan 503 sendiri.
Ia meneruskan 503 dari aplikasi di belakangnya.
Atau menjawab 503 karena limit dan aturan di konfigurasinya.
Cara tercepat mendiagnosis 503 di Nginx:
- Pantau log error:
tail -f /var/log/nginx/error.loglalu muat ulang halaman. - Perhatikan baris yang muncul: upstream, limiting requests, atau aturan return 503.
- Perbaiki lapisan itu saja — lalu reload Nginx dan uji lagi dengan curl.
Halaman Default 503 Nginx
Halaman yang tertangkap lab kami, persis seperti tampilannya:
503 Service Temporarily Unavailable
nginx
Footer itu petunjuk pertama, bukan vonisnya.
Artinya respons ini dibuat Nginx di lapisannya sendiri.
Ada limit atau aturan di dalam Nginx yang memutuskan 503.
Tapi Nginx juga mengantar 503 yang bukan buatannya.
Kalau aplikasimu menjawab 503, Nginx meneruskannya utuh.
Pengunjung melihat halaman aplikasi, bukan halaman default ini.
Satu kode status, tiga pengirim yang berbeda.
Log error menyebut siapa pengirimnya. Selalu mulai dari sana.
Baru kenal kode ini? Mulai dari panduan dasar error 503.
Baca Log Error Dulu: 4 Baris Penentu
Muat ulang halaman yang gagal sekali, lalu baca baris terbaru.
Empat baris ini mencakup hampir semua 503 di Nginx.
| Baris log error diawali | Pengirim | Artinya | Perbaikan pertama |
|---|---|---|---|
limiting requests, excess: … by zone "…" |
limit_req | Request datang lebih cepat daripada jatah zona. | Naikkan rate dan burst mengikuti puncak asli (Penyebab 2). |
limiting connections by zone "…" |
limit_conn | Satu IP memegang koneksi paralel melebihi jatah. | Naikkan limit, atau kecualikan jalur IP bersama (Penyebab 2). |
upstream timed out … while reading response header |
Upstream | Aplikasi menerima request tapi menjawab terlalu lambat. Pengunjungmu melihat 504, bukan 503. | Bebaskan atau ubah ukuran pool worker (Penyebab 1). |
connect() to unix:… failed |
Upstream | Proses aplikasi mati atau socket-nya hilang. Pengunjungmu melihat 502. | Jalankan upstream, lalu cari sebab matinya (Penyebab 1). |
Kasus kelima: tidak ada baris baru sama sekali.
Sepi berarti Nginx melihat respons upstream yang normal.
Upstream sendiri yang menjawab 503, dan Nginx mengantarnya.
Itu Penyebab 4 di bawah — dan paling sering mengecoh.
Bingung kodemu 502, 503, atau 504?
HTTP Status Code Explorer membandingkannya berdampingan.

Penyebab 1: Upstream (PHP-FPM / Aplikasi) Menolak atau Penuh
Ini kejutan yang dibuktikan lab kami dua kali.
Pool PHP-FPM yang penuh tidak menjawab 503 lewat Nginx.
Request menunggu di antrean pool.
Nginx ikut menunggu, sampai batas baca timeout-nya habis.
Pengunjung lalu menerima 504, bukan 503.
Uji kami: tiga worker, dua belas request paralel 20 detik.
Tiga selesai di detik 20. Sembilan mati sebagai 504 di detik 30.
Log FPM menyebut masalah sebenarnya dalam satu baris:
[16-Nov-2026 15:03:16] WARNING: [pool lab8] server reached pm.max_children setting (3), consider raising it
Nginx mencatat timeout-nya, request demi request:
upstream timed out (110: Connection timed out) while reading response header from upstream
Upstream yang mati total menghasilkan kode lain lagi.
Kami hentikan PHP-FPM sepenuhnya dan memuat ulang halaman.
Pengunjung menerima 502, dan log menjelaskan sebabnya:
connect() to unix:/run/php/lab8.sock failed (2: No such file or directory) while connecting to upstream
Jadi curigai laporan 503 yang menyalahkan upstream.
Perbaikannya milik pool, bukan milik Nginx.
Cari dulu apa yang menahan worker-mu sebelum menaikkan limit.
Ukuran pool, hitungan RAM, dan berburu slowlog ada di panduan 503 PHP-FPM.
Menaikkan fastcgi_read_timeout hanya menyembunyikan antrean lebih lama.
Ia mengubah 504 menjadi 200 yang lambat — sampai trafik naik lagi.
Penyebab 2: limit_req dan limit_conn Bekerja Terlalu Ketat
Rate limit di Nginx menolak dengan 503 secara default.
Default itu mengejutkan tim yang mengharapkan 429.
Zona lab kami mengizinkan satu request per menit, burst dua:
limit_req_zone $binary_remote_addr zone=lab8_burst:10m rate=1r/m;
location = /limited.php {
limit_req zone=lab8_burst burst=2 nodelay;
# fastcgi settings omitted
}
Sepuluh request cepat: tiga pertama lolos, tujuh ditolak.
Setiap penolakan menulis pengakuan yang sama ke log error:
limiting requests, excess: 3.000 by zone "lab8_burst", client: 127.0.0.1, server: lab8.local, request: "GET /limited.php HTTP/1.1"
Sisa situs tetap menyala selama uji berlangsung.
Hanya location yang dibatasi itu yang menjawab 503.
limit_conn berperilaku sama, hanya menghitung koneksi.
Satu koneksi per IP; tiga request paralel lima detik berpacu.
Satu berjalan lima detik; dua ditolak seketika.
limiting connections by zone "lab8_conn", client: 127.0.0.1, server: lab8.local, request: "GET /slow.php?s=5 HTTP/1.1"
Perbaikannya penyesuaian, bukan penghapusan.
Pasangan teruji kami meloloskan kesepuluh request dengan bersih:
limit_req_zone $binary_remote_addr zone=lab8_burst:10m rate=20r/s;
limit_req zone=lab8_burst burst=20 nodelay;
Rate dan burst wajib naik bersamaan.
Menaikkan rate saja tetap menolak separuh burst uji kami.
Ukur puncak aslimu dulu, lalu pasang kedua angka di atasnya.
Ingat juga IP bersama: kantor dan operator seluler me-NAT ribuan orang.
Limit per-IP yang pas untuk bot bisa pas juga untuk satu gedung.
Penyebab 3: Aturan Maintenance atau Geo yang Sengaja Menjawab 503
Sebagian 503 bukan bug sama sekali.
Rekan tim, dirimu di masa lalu, atau skrip deploy yang menambah aturannya.
Pola profesionalnya adalah berkas saklar, teruji di lab kami:
map $remote_addr $maint_exempt {
default 0;
127.0.0.2 1;
}
set $maint 0;
if (-f $document_root/maintenance.on) { set $maint 1; }
if ($maint_exempt) { set $maint 0; }
if ($maint) { return 503; }
error_page 503 @maintenance;
location @maintenance {
add_header Retry-After 3600 always;
default_type text/plain;
return 503 "This site is temporarily unavailable while we run maintenance. Please retry in about an hour.";
}
Dengan berkas terpasang, pengunjung menerima persis itu.
Status 503, header Retry-After: 3600, dan kalimat khususnya.
Alamat uji kami yang dikecualikan browsing normal di saat bersamaan.
Menghapus berkasnya memulihkan 200 pada request berikutnya.
Tanpa reload — pemeriksaannya berjalan per request.
Aturan geo memakai mekanisme yang sama persis.
Map berdasarkan negara atau alamat mengalir ke return 503 yang sama.
Jadi sebelum debug mendalam, grep konfigurasimu untuk return 503.
Lalu periksa berkas saklar yang mungkin ditinggalkan proses deploy.
Begitu saklar mati, cek kode status URL mana pun untuk membuktikan situs menjawab normal lagi.
Perbaikan penyebab ini adalah keputusan, bukan reparasi.
Maintenance-nya memang nyata, atau aturan sisanya yang dicabut.
Penyebab 4: Pool Upstream Habis di Balik Reverse Proxy
Di balik reverse proxy, 503 sering memakai baju aplikasimu.
Tier aplikasi lab kami mengembalikan kalimat 503-nya sendiri.
Nginx di depannya meneruskannya kata demi kata.
Access log-nya mencatat 503 — error log-nya tidak mencatat apa pun.
Kesepian itulah tanda tangannya, seperti di tabel atas.
Kalau tier aplikasi adalah satu dari beberapa backend, aktifkan failover:
upstream lab8_backend_failover {
server 127.0.0.1:8092 max_fails=2 fail_timeout=10s;
server 127.0.0.1:8093 backup;
}
location /failover/ {
proxy_pass http://lab8_backend_failover/;
proxy_next_upstream error timeout http_503;
proxy_connect_timeout 2s;
proxy_read_timeout 5s;
}
Tanpa http_503 di proxy_next_upstream, Nginx mengantar 503 itu.
Dengan http_503, klien uji kami menerima 200 dari backup.
Access log backend utama membuktikan ia menjawab 503 lebih dulu.
Dua pelajaran bersembunyi di eksperimen kecil itu.
Pertama: catat log juga di backend, atau failover tidak terlihat.
Kedua: max_fails butuh kegagalan nyata sebelum bisa melindungimu.
Untuk menangkap backend sekarat sebelum pengunjung, lihat Health Checks That Actually Work.
Reproduksi Lab Kami
Setiap klaim di atas direproduksi sebelum ditulis.
Stack: nginx 1.26.3 di depan PHP-FPM 8.4, Debian 13.
Satu endpoint lambat — skrip PHP tidur 20 detik — memasok bebannya.
Uji A — limit_req menolak dengan 503
Zona satu request per menit, burst dua, ember kosong.
Sepuluh request cepat: tiga kali 200, lalu tujuh kali 503.
Log error: limiting requests, excess: 3.000 by zone “lab8_burst”.
Zona diperbaiki (20r/s, burst 20): sepuluh dari sepuluh kembali 200.
Uji B — limit_conn menolak dengan 503
Satu koneksi per IP; tiga request paralel lima detik.
Satu selesai di lima detik; dua ditolak dalam milidetik.
Log error: limiting connections by zone “lab8_conn”.
Uji C — berkas saklar maintenance
Berkas terpasang: 503, Retry-After: 3600, badan khusus.
Alamat sumber terkecuali di saat yang sama: 200.
Berkas dihapus: 200 pada request berikutnya, tanpa reload.
Uji D — upstream jenuh dan mati
Pool dipotong ke tiga worker; dua belas request lambat paralel.
Hasil: tiga 200 di detik 20, sembilan 504 di detik 30.
Log FPM: server reached pm.max_children setting (3).
Log Nginx: upstream timed out … while reading response header.
Tidak satu pun 503 muncul di uji ini.
Pool dipulihkan ke sepuluh worker: delapan request paralel, delapan 200.
Dengan FPM dihentikan: 502, plus baris connect() failed.
Uji E — penerusan reverse proxy dan failover
Satu backend menjawab 503-nya sendiri: klien menerimanya verbatim.
Error log proxy depan bertambah nol baris selama request itu.
Failover dengan proxy_next_upstream http_503: klien menerima 200.
Access log backend utama menunjukkan upaya 503-nya lebih dulu.
Setiap konfigurasi di artikel ini lolos nginx -t di lab.
Yang Tidak Berhasil
Asumsi pertama kami gagal: pool penuh akan menjawab 503.
Ternyata ia menjawab 504 saat timeout dan 502 saat mati.
Siapa pun yang debug hanya dari kode status akan salah membaca lapisan ini.
Uji limit pertama kami mengotori dirinya dua kali.
Berkas target tidak ada, jadi request yang lolos berbalik 404.
Lalu memori zona selamat dari reload dan menolak semuanya.
Restart penuh, bukan reload, yang mengosongkan zona limit.
Kecelakaan itu juga mengajarkan kami tidak memercayai restart sebagai perbaikan.
Ia “memperbaiki” 503 limit dengan menghapus buktinya.
Terakhir, menaikkan rate saja tidak memperbaiki burst kami.
Di 20r/s dengan burst tetap dua, separuh burst ditolak.
Burst adalah angka yang benar-benar ditemui puncak trafikmu.
FAQ
Kenapa Nginx menjawab 503, bukan 502, di kasus ini?
Karena 502 dan 504 adalah vonis Nginx sendiri soal upstream.
503 berarti aturan atau limit di Nginx, atau jawaban aplikasi sendiri.
Di mana log error Nginx di server saya?
Secara default, /var/log/nginx/error.log.
Direktif error_log per-vhost menimpanya — lab kami memakai path khusus.
Jalankan nginx -T | grep error_log untuk melihat milikmu.
Apakah restart Nginx memperbaiki 503?
Sebentar, kadang: ia mengosongkan zona limit dan antrean macet.
Penyebabnya kembali bersama burst trafik berikutnya.
Lab kami menyaksikan restart menghapus bukti, bukan masalahnya.
Bisakah rate limit menyebabkan 503 bagi pengunjung asli?
Bisa — lab kami menolak tujuh dari sepuluh request biasa.
IP bersama dan burst di bawah puncak asli adalah jebakan lazimnya.
Semua panduan dan alat gratis kami ada di beranda 503.my.id berbahasa Indonesia.
Sumber dan tanggal: reproduksi lab dijalankan 16 November 2026 di nginx 1.26.3 dan PHP-FPM 8.4.27 (Debian 13).
Perilaku direktif mengikuti dokumentasi modul nginx resmi yang dirujuk di bawah. Definisi mengikuti RFC 9110.
Referensi
- Dokumentasi nginx — ngx_http_limit_req_module (limit_req_zone, limit_req, status penolakan).
- Dokumentasi nginx — ngx_http_limit_conn_module (limit_conn_zone, limit_conn).
- Modul nginx — ngx_http_upstream_module (max_fails, fail_timeout) dan ngx_http_proxy_module (proxy_next_upstream).
- nginx — direktif error_log dan level log.
- RFC 9110 §15.6.4 — 503 Service Unavailable (IETF).
- RFC 9110 §10.2.3 — Retry-After (IETF).

Leave a Reply