DevToolPal
VI
5xx Lỗi phía máy chủ

504 Gateway Timeout

Gateway hết thời gian chờ

Ý nghĩa

Một gateway hoặc proxy không nhận được phản hồi kịp thời từ máy chủ upstream.

Nguyên nhân thường gặp

  • Truy vấn cơ sở dữ liệu hoặc lời gọi API bên ngoài chậm
  • Thời gian chờ của proxy ngắn hơn thời gian xử lý
  • Không truy cập được máy chủ upstream do sự cố mạng

Cách khắc phục

Nếu bạn là máy khách hoặc người truy cập

Thử lại sau; với thao tác dài, hãy hỏi xem API có xử lý bất đồng bộ không.

Nếu bạn quản lý trang web hoặc API

Tăng tốc đường xử lý chậm hoặc chuyển sang tác vụ nền; chỉ nâng thời gian chờ proxy (proxy_read_timeout) tới mức thực tế.

Phản hồi mẫu

HTTP/1.1
HTTP/1.1 504 Gateway Timeout
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Length: 0

Đặc tả

RFC 9110 §15.6.5

Câu hỏi thường gặp

› Làm sao sửa 504 Gateway Timeout trong nginx?

Tìm lý do upstream chậm; nếu yêu cầu dài là bình thường, hãy tăng proxy_read_timeout cùng với thời gian chờ của máy chủ ứng dụng.

› Ai trả 504, ứng dụng của tôi hay proxy?

Proxy, bộ cân bằng tải hoặc CDN đứng trước ứng dụng, sau khi chờ nó quá lâu.