⏱️
Хостинг

504 Gateway Timeout: хато сабаби ва уни босқичма-босқич тузатиш

17.11.2026
← Барча мақолалар

Браузерда "504 Gateway Timeout" ёзуви чиқса, кўпчилик сайт бутунлай ишламай қолди деб ўйлайди. Аслида бу хато анча аниқ нарсани билдиради: олдинда турган сервер (одатда Nginx) сўровни орқадаги иловага узатган, лекин белгиланган вақт ичида жавоб ололмаган. Яъни илова ишлаб турган бўлиши мумкин, фақат жуда секин. Шу фарқни тушуниш тўғри ечим топишнинг биринчи қадами, чунки 504 ни тузатиш кўпинча сервер эмас, балки кодни ёки маълумотлар базасини тузатишни талаб қилади.

504 ва 502 фарқи

Иккала хато ҳам "gateway", яъни оралиқ сервер билан боғлиқ, лекин маъноси турлича. 502 Bad Gateway орқадаги илова нотўғри жавоб қайтарганда ёки умуман уланишни қабул қилмаганда чиқади: масалан PHP-FPM ўчиб қолган ёки Node.js жараёни йиқилган. 504 эса уланиш ўрнатилган, сўров юборилган, лекин жавоб келмагунча кутиш вақти тугаган ҳолат. Бошқача айтганда, 502 "ҳеч ким жавоб бермади", 504 эса "жавоб жуда узоқ чўзилди" дегани.

Энг кўп учрайдиган сабаблар

Амалиётда 504 хатосининг аксарияти бир неча типик вазиятдан келиб чиқади. Уларни билиш логларни ўқишни анча тезлаштиради:

Сабабни логлардан топиш

Тахмин қилиш ўрнига биринчи навбатда Nginx хато логига қараш керак. VPS'да бу одатда /var/log/nginx/error.log файли. 504 ҳолатида у ерда қуйидагига ўхшаш ёзув бўлади:

upstream timed out (110: Connection timed out) while reading response header from upstream,
client: 203.0.113.25, server: example.uz, request: "POST /admin/import HTTP/1.1",
upstream: "fastcgi://unix:/run/php/php8.2-fpm.sock"

Бу ёзувдан қайси манзил секин ишлаётганини (request) ва қайси backend жавоб бермаганини (upstream) аниқ билиб оласиз. Агар хато фақат битта саҳифада чиқса, муаммо шу саҳифа кодида. Агар бутун сайт бўйлаб чиқса, умумий ресурс, масалан маълумотлар базаси ёки PHP-FPM ишчилари тугаган бўлиши эҳтимоли катта.

Кейинги қадам маълумотлар базасини текшириш. MySQL ёки MariaDB'да ҳозир бажарилаётган сўровларни кўриш учун қуйидаги буйруқ ишлатилади. Time устунида катта қийматли сўровлар асосий гумондор ҳисобланади:

mysql -u root -p -e "SHOW FULL PROCESSLIST;"

Доимий кузатув учун секин сўровлар логини ёқиш фойдали. У белгиланган вақтдан узоқ давом этган ҳар бир сўровни ёзиб боради ва қайси жадвалга индекс кераклигини кўрсатади:

SET GLOBAL slow_query_log = 'ON';
SET GLOBAL long_query_time = 2;

Вақт чегаралари қаерда белгиланади

Сўров йўлида бир нечта қатлам бор ва ҳар бирининг ўз вақт чегараси мавжуд. Улардан энг қисқаси биринчи бўлиб ишга тушади, шунинг учун биттасини ошириб, бошқасини унутсангиз, хато бошқа кўринишда қайтаверади.

ҚатламСозламаВазифаси
Nginx (proxy)proxy_read_timeoutNode.js, Python ёки бошқа HTTP backend жавобини кутиш
Nginx (PHP)fastcgi_read_timeoutPHP-FPM жавобини кутиш
PHPmax_execution_timeСкриптнинг бажарилиш вақти чегараси
PHP-FPMrequest_terminate_timeoutPool даражасида сўровни мажбуран тўхтатиш

Nginx'нинг иккала параметри ҳам стандарт ҳолатда 60 сония. Ҳақиқатан ҳам узоқ давом этиши керак бўлган махсус манзил учун уларни фақат шу location ичида ошириш тўғри ёндашув:

location = /admin/import.php {
    fastcgi_read_timeout 300s;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_pass unix:/run/php/php8.2-fpm.sock;
}

Бутун сайт учун вақт чегарасини бир неча дақиқага кўтариш эса хавфли: секин сўровлар ишчиларни узоқроқ банд қилади ва юқори трафикда сайт янада тезроқ чўкади.

Мисол: Андижондаги мактаб сайти ва баҳолар экспорти

Андижондаги хусусий мактаб сайтида ўқитувчилар чорак охирида барча синфлар баҳоларини битта Excel файлга экспорт қилади. Дастлаб ҳаммаси яхши ишлаган, лекин ўқувчилар сони ошгач, экспорт тугмаси 504 хатосини қайтара бошлаган. Логда /teacher/export манзили ва upstream timed out ёзуви кўринган, секин сўровлар логида эса баҳолар жадвали бўйича индексиз қидирув топилган. student_id ва quarter устунларига индекс қўшилгач, сўров бир неча сонияда бажарила бошлаган. Кейинроқ экспорт фон вазифасига ўтказилган: ўқитувчи тугмани босади, файл тайёр бўлгач уни юклаб олиш ҳаволаси чиқади.

Тўғри ечимлар тартиби

  1. Секин жойни топинг. Nginx логи, секин сўровлар логи ва илова логлари орқали айнан қайси сўров ва қайси операция вақт олаётганини аниқланг.
  2. Сўровни тезлаштиринг. Индекс қўшинг, кераксиз маълумотни юкламанг, натижани кешланг. Кўп ҳолларда шу қадамнинг ўзи муаммони ҳал қилади.
  3. Ташқи API'ларга қисқа timeout қўйинг. cURL'да CURLOPT_TIMEOUT каби параметр билан ташқи хизматни чексиз кутманг, хатони фойдаланувчига тушунарли кўринишда қайтаринг.
  4. Оғир ишларни фонга чиқаринг. Импорт, экспорт, оммавий жўнатма каби вазифаларни навбат ва cron орқали бажаринг.
  5. Шундан кейингина timeout'ни оширинг, ва фақат ҳақиқатан узоқ ишлаши керак бўлган манзиллар учун.

Виртуал хостингда нима қилиш мумкин

Виртуал хостингда Nginx ва PHP-FPM созламалари сервер администратори қўлида бўлади, лекин кўп нарсани ўзингиз текшира оласиз. ISPmanager панелида сайт хато логларини кўриш, PHP версияси ва баъзи параметрларни ўзгартириш мумкин, панелга эса sayt.uz кабинетидан кирилади. WordPress сайтларида 504 кўпинча битта оғир плагин, захира нусха яратувчи кенгайтма ёки нотўғри созланган cron вазифаси билан боғлиқ бўлади, шунинг учун охирги ўрнатилган плагинларни вақтинча ўчириб кўриш фойдали. Агар сабаб сервер даражасида бўлса ёки логларда аниқ жавоб топа олмасангиз, хато чиққан вақт ва манзилни кўрсатиб техник ёрдамга тикет ёзинг: бу текширувни сезиларли тезлаштиради.

Ўхшаш мақолалар

💾 VPS'да swap: керакми, қанча ва қандай созланади 🗂️ ISPmanager файл менежери билан ишлаш: юклаш, архив, таҳрир ва рухсатлар 📜 Хостинг SLA: кафолатлар, uptime фоизи ва компенсация қандай ишлайди 📚 OJS илмий журнал сайти учун хостинг: талаблар ва тўғри созлаш
🌐 Тил
🇺🇿 O'zbek 🇺🇿 Ўзбек ✓ 🇷🇺 Русский 🇬🇧 English