ماذا يعني
لم تتلق بوابة أو خادم وكيل استجابة في الوقت المناسب من الخادم الخلفي.
الأسباب الشائعة
- استعلامات قاعدة بيانات أو استدعاءات API خارجية بطيئة
- مهلة الوكيل أقصر من وقت المعالجة
- تعذر الوصول إلى الخادم الخلفي بسبب مشكلات الشبكة
طريقة الإصلاح
إن كنت العميل أو الزائر
أعد المحاولة لاحقًا؛ وللعمليات الطويلة اسأل إن كانت الواجهة توفر معالجة غير متزامنة.
إن كنت مسؤولًا عن الموقع أو الواجهة البرمجية
سرّع المسار البطيء أو انقله إلى مهمة في الخلفية؛ وارفع مهلات الوكيل (proxy_read_timeout) إلى قيم واقعية فقط.
مثال على الاستجابة
HTTP/1.1
HTTP/1.1 504 Gateway Timeout
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Length: 0المواصفة
الأسئلة الشائعة
› كيف أصلح 504 Gateway Timeout في nginx؟
اكتشف سبب بطء الخادم الخلفي؛ وإن كانت الطلبات الطويلة متوقعة، فارفع proxy_read_timeout ومهلة خادم التطبيق معًا.
› من يعيد 504، تطبيقي أم الوكيل؟
الوكيل أو موازن التحميل أو CDN الموجود أمام تطبيقك، بعد أن انتظره طويلًا.