Ý nghĩa
Máy chủ tạm thời không thể xử lý yêu cầu do quá tải hoặc bảo trì. Retry-After có thể cho biết khi nào thử lại.
Nguyên nhân thường gặp
- Bảo trì theo kế hoạch
- Máy chủ quá tải hoặc hết worker
- Tự động mở rộng chưa theo kịp, hoặc phụ thuộc bị gián đoạn
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, tuân theo Retry-After.
Nếu bạn quản lý trang web hoặc API
Gửi Retry-After khi bảo trì, mở rộng năng lực và giảm tải một cách êm ái. Công cụ tìm kiếm coi 503 ngắn là tạm thời.
Phản hồi mẫu
HTTP/1.1
HTTP/1.1 503 Service Unavailable
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Retry-After: 120
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Service Unavailable",
"status": 503,
"detail": "Down for maintenance until 02:00 UTC."
}Đặc tả
Câu hỏi thường gặp
› 503 có phù hợp cho trang bảo trì không?
Có. Trả 503 kèm Retry-After; công cụ tìm kiếm sẽ giữ trang trong chỉ mục thay vì coi nó đã mất.
› 503 hay 500?
503 nói sự cố là tạm thời và sẽ phục hồi; 500 là lỗi không mong đợi.