ความหมาย
เกตเวย์หรือพร็อกซีไม่ได้รับการตอบกลับจากเซิร์ฟเวอร์ upstream ภายในเวลา
สาเหตุที่พบบ่อย
- query ฐานข้อมูลหรือการเรียก API ภายนอกช้า
- timeout ของพร็อกซีสั้นกว่าเวลาประมวลผล
- เข้าถึงเซิร์ฟเวอร์ upstream ไม่ได้เพราะปัญหาเครือข่าย
วิธีแก้ไข
สำหรับไคลเอนต์หรือผู้เยี่ยมชม
ลองใหม่ภายหลัง สำหรับงานที่ใช้เวลานาน ให้ถามว่า API มีการประมวลผลแบบอะซิงโครนัสหรือไม่
สำหรับผู้ดูแลเว็บไซต์หรือ API
เร่งเส้นทางที่ช้าหรือย้ายไปเป็นงานเบื้องหลัง เพิ่ม timeout ของพร็อกซี (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 อย่างไร
หาว่าทำไม upstream ช้า หากคำขอยาวเป็นเรื่องปกติ ให้เพิ่ม proxy_read_timeout พร้อมกับ timeout ของเซิร์ฟเวอร์แอป
› ใครคืน 504 แอปของฉันหรือพร็อกซี
พร็อกซี load balancer หรือ CDN ที่อยู่หน้าแอปของคุณ หลังจากรอแอปนานเกินไป