Браузерда "504 Gateway Timeout" ёзуви чиқса, кўпчилик сайт бутунлай ишламай қолди деб ўйлайди. Аслида бу хато анча аниқ нарсани билдиради: олдинда турган сервер (одатда Nginx) сўровни орқадаги иловага узатган, лекин белгиланган вақт ичида жавоб ололмаган. Яъни илова ишлаб турган бўлиши мумкин, фақат жуда секин. Шу фарқни тушуниш тўғри ечим топишнинг биринчи қадами, чунки 504 ни тузатиш кўпинча сервер эмас, балки кодни ёки маълумотлар базасини тузатишни талаб қилади.
504 ва 502 фарқи
Иккала хато ҳам "gateway", яъни оралиқ сервер билан боғлиқ, лекин маъноси турлича. 502 Bad Gateway орқадаги илова нотўғри жавоб қайтарганда ёки умуман уланишни қабул қилмаганда чиқади: масалан PHP-FPM ўчиб қолган ёки Node.js жараёни йиқилган. 504 эса уланиш ўрнатилган, сўров юборилган, лекин жавоб келмагунча кутиш вақти тугаган ҳолат. Бошқача айтганда, 502 "ҳеч ким жавоб бермади", 504 эса "жавоб жуда узоқ чўзилди" дегани.
Энг кўп учрайдиган сабаблар
Амалиётда 504 хатосининг аксарияти бир неча типик вазиятдан келиб чиқади. Уларни билиш логларни ўқишни анча тезлаштиради:
- Секин SQL сўровлар. Индекссиз катта жадвалда қидирув, ўн минглаб қаторни бирлаштириш ёки блокланган жадвал саҳифани бир неча дақиқага тўхтатиб қўяди.
- Ташқи хизматларни кутиш. Тўлов тизими, SMS шлюзи, валюта курси ёки етказиб бериш API'си жавоб бермаса, сизнинг скриптингиз ҳам уни кутиб қолади.
- Оғир фон ишлари сўров ичида. Катта Excel импорт, юзлаб расмни қайта ўлчаш, PDF ҳисобот яратиш ёки оммавий email жўнатиш бевосита браузер сўровида бажарилса, вақт чегарасига осонгина етади.
- Банд PHP-FPM ишчилари. Барча ишчи жараёнлар секин сўровлар билан банд бўлса, янги сўровлар навбатда туради ва охир-оқибат вақти тугайди. Бу кўпинча бот ҳужуми ёки тўсатдан ошган трафик билан бирга келади.
- Сервер ресурслари тугаши. Хотира етишмаса тизим swap'га ўтади ёки жараёнларни ўлдиради, диск жуда банд бўлса ҳар бир операция секинлашади.
Сабабни логлардан топиш
Тахмин қилиш ўрнига биринчи навбатда 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_timeout | Node.js, Python ёки бошқа HTTP backend жавобини кутиш |
| Nginx (PHP) | fastcgi_read_timeout | PHP-FPM жавобини кутиш |
| PHP | max_execution_time | Скриптнинг бажарилиш вақти чегараси |
| PHP-FPM | request_terminate_timeout | Pool даражасида сўровни мажбуран тўхтатиш |
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 устунларига индекс қўшилгач, сўров бир неча сонияда бажарила бошлаган. Кейинроқ экспорт фон вазифасига ўтказилган: ўқитувчи тугмани босади, файл тайёр бўлгач уни юклаб олиш ҳаволаси чиқади.
Тўғри ечимлар тартиби
- Секин жойни топинг. Nginx логи, секин сўровлар логи ва илова логлари орқали айнан қайси сўров ва қайси операция вақт олаётганини аниқланг.
- Сўровни тезлаштиринг. Индекс қўшинг, кераксиз маълумотни юкламанг, натижани кешланг. Кўп ҳолларда шу қадамнинг ўзи муаммони ҳал қилади.
- Ташқи API'ларга қисқа timeout қўйинг. cURL'да
CURLOPT_TIMEOUTкаби параметр билан ташқи хизматни чексиз кутманг, хатони фойдаланувчига тушунарли кўринишда қайтаринг. - Оғир ишларни фонга чиқаринг. Импорт, экспорт, оммавий жўнатма каби вазифаларни навбат ва cron орқали бажаринг.
- Шундан кейингина timeout'ни оширинг, ва фақат ҳақиқатан узоқ ишлаши керак бўлган манзиллар учун.
Виртуал хостингда нима қилиш мумкин
Виртуал хостингда Nginx ва PHP-FPM созламалари сервер администратори қўлида бўлади, лекин кўп нарсани ўзингиз текшира оласиз. ISPmanager панелида сайт хато логларини кўриш, PHP версияси ва баъзи параметрларни ўзгартириш мумкин, панелга эса sayt.uz кабинетидан кирилади. WordPress сайтларида 504 кўпинча битта оғир плагин, захира нусха яратувчи кенгайтма ёки нотўғри созланган cron вазифаси билан боғлиқ бўлади, шунинг учун охирги ўрнатилган плагинларни вақтинча ўчириб кўриш фойдали. Агар сабаб сервер даражасида бўлса ёки логларда аниқ жавоб топа олмасангиз, хато чиққан вақт ва манзилни кўрсатиб техник ёрдамга тикет ёзинг: бу текширувни сезиларли тезлаштиради.