Lỗi 502 Bad Gateway Là Gì? Nguyên Nhân Và Cách Khắc Phục

Lỗi 502 Bad Gateway là mã trạng thái HTTP cho biết một máy chủ đang đóng vai trò gateway hoặc proxy đã nhận phản hồi không hợp lệ từ máy chủ phía sau, còn gọi là upstream. Nói đơn giản: trình duyệt đã kết nối được với “cửa ngõ”, nhưng cửa ngõ không lấy được câu trả lời hợp lệ từ ứng dụng cần phục vụ.

Người truy cập thường chỉ cần tải lại trang, thử mạng khác và chờ quản trị viên xử lý. Chủ website cần kiểm tra theo chuỗi: gateway → DNS → cổng và giao thức → backend → log ứng dụng → timeout, TLS và tài nguyên hệ thống. Tăng timeout một cách máy móc hiếm khi là giải pháp lâu dài.

Lỗi 502 Bad Gateway là gì?

Theo RFC 9110, máy chủ trả 502 khi nó hoạt động như gateway hoặc proxy và nhận phản hồi không hợp lệ từ máy chủ inbound/upstream. Gateway có thể là Nginx, CDN, load balancer, API gateway hoặc một dịch vụ reverse proxy.

Một request phổ biến đi theo luồng:

Trình duyệt → CDN / reverse proxy → ứng dụng backend → cơ sở dữ liệu

Nếu trình duyệt không kết nối được với CDN, người dùng có thể gặp lỗi DNS hoặc lỗi kết nối. Nếu gateway kết nối được nhưng backend từ chối, đóng kết nối sớm hoặc gửi phản hồi không thể xử lý, gateway có thể trả 502.

Khái niệm này dễ bị nhầm với forward proxy dùng để đại diện cho máy khách. Bài proxy là gì giải thích rõ proxy xuôi, proxy ngược và vai trò của từng loại.

Phân biệt 500, 502, 503 và 504

Mã lỗi Ý nghĩa chính Nơi thường phát sinh Câu hỏi cần kiểm tra đầu tiên
500 Internal Server Error Ứng dụng gặp lỗi nội bộ Backend Stack trace hoặc exception nào vừa xảy ra?
502 Bad Gateway Gateway nhận phản hồi upstream không hợp lệ Proxy/CDN/load balancer Gateway có kết nối đúng host, cổng và giao thức không?
503 Service Unavailable Dịch vụ tạm thời không sẵn sàng Gateway hoặc backend Dịch vụ đang bảo trì, quá tải hay không có instance khỏe?
504 Gateway Timeout Upstream không phản hồi trong thời hạn Gateway Backend chậm ở bước nào và timeout nào đã hết?

Ranh giới không phải lúc nào cũng hoàn hảo vì mỗi nền tảng có cách ánh xạ lỗi khác nhau. Vì vậy, mã trạng thái chỉ là điểm bắt đầu; log của gateway và ứng dụng mới giúp xác định nguyên nhân.

Các thông báo 502 thường gặp

Tùy hệ thống, người dùng có thể thấy “502 Bad Gateway”, “HTTP Error 502”, “502 Proxy Error”, “Bad Gateway: The proxy server received an invalid response” hoặc trang lỗi mang thương hiệu CDN. Một số trang chỉ hiển thị “Something went wrong” nhưng header HTTP vẫn là 502.

Với Cloudflare, giao diện lỗi có hoặc không có thương hiệu Cloudflare giúp khoanh vùng sự cố. Trang hỗ trợ chính thức khuyến nghị phân biệt lỗi phát sinh ở hạ tầng Cloudflare với lỗi do origin trả về. Dù vậy, người vận hành vẫn cần kiểm tra log theo đúng thời điểm và mã ray/request ID nếu có.

Nguyên nhân gây lỗi 502 Bad Gateway

Backend dừng hoặc chưa khởi động

Nginx có thể trỏ tới 127.0.0.1:3000, nhưng ứng dụng Node.js lại dừng, khởi động chậm hoặc nghe ở cổng khác. Khi kết nối bị từ chối, error log thường chứa thông báo tương tự “connection refused while connecting to upstream”.

Sai host, cổng, giao thức hoặc Unix socket

Một thay đổi nhỏ như backend chuyển từ cổng 3000 sang 8080, từ HTTP sang HTTPS hoặc đổi đường dẫn socket đủ để tạo 502. Trong Docker, localhost bên trong container Nginx thường trỏ tới chính container đó, không phải container ứng dụng.

Ứng dụng đóng kết nối trước khi gửi đủ header

Backend có thể crash, hết bộ nhớ hoặc phát sinh exception sau khi chấp nhận kết nối. Gateway nhận kết nối bị đóng sớm và không có header HTTP hợp lệ nên trả 502.

Quá tải tài nguyên

CPU cao, cạn RAM, hết worker, đầy connection pool hoặc quá nhiều file descriptor đều có thể làm backend phản hồi bất thường. Lúc này, khởi động lại có thể giảm triệu chứng trong thời gian ngắn nhưng không thay thế việc tìm nút thắt.

DNS nội bộ sai hoặc chưa cập nhật

Gateway có thể phân giải tên upstream sang IP cũ. Điều này hay xuất hiện sau khi đổi máy chủ, service discovery hoặc bản ghi DNS. Kiểm tra từ đúng môi trường chạy gateway, vì máy cá nhân và container có thể dùng resolver khác nhau.

Firewall hoặc security group chặn kết nối

Quy tắc mạng có thể cho phép trình duyệt vào CDN nhưng chặn CDN hoặc load balancer kết nối origin. Hãy kiểm tra chiều kết nối, cổng đích và dải IP được phép; không nên mở toàn bộ cổng ra Internet chỉ để thử.

TLS giữa gateway và origin lỗi

Chứng chỉ hết hạn, SNI sai, hostname không khớp hoặc bộ mã hóa không tương thích có thể làm kết nối HTTPS tới upstream thất bại. Log handshake thường rõ hơn trang lỗi người dùng nhìn thấy.

Header hoặc nội dung phản hồi không hợp lệ

Header quá lớn, định dạng sai, kết nối đóng giữa chừng hoặc dữ liệu nén bị lỗi đều có thể khiến gateway không xử lý được. Cloudflare cũng ghi nhận trường hợp Content-Length không khớp hoặc phản hồi gzip bị hỏng dẫn tới lỗi 502/504.

Không còn upstream khỏe

Load balancer loại tất cả instance khỏi pool khi health check thất bại. Nguyên nhân có thể là đường dẫn health check sai, ứng dụng chưa sẵn sàng hoặc dependency phía sau đang lỗi.

Cách sửa lỗi 502 cho người truy cập

Nếu bạn chỉ đang mở website, quyền xử lý khá hạn chế. Hãy làm theo thứ tự sau:

  1. Tải lại trang một lần sau khoảng 30–60 giây. Không nhấp gửi lại liên tục nếu vừa thực hiện thanh toán hoặc gửi biểu mẫu.

  2. Mở một trang khác của cùng website để xem lỗi xảy ra toàn hệ thống hay chỉ một chức năng.

  3. Thử cửa sổ riêng tư hoặc trình duyệt khác nhằm loại trừ extension và cache cục bộ.

  4. Thử một mạng khác. Nếu chỉ một mạng lỗi, có thể DNS, proxy doanh nghiệp hoặc nhà mạng đang gặp vấn đề.

  5. Kiểm tra trang trạng thái chính thức của dịch vụ rồi báo quản trị viên kèm thời điểm, URL và ảnh chụp lỗi.

Xóa toàn bộ cookie hiếm khi sửa được 502 vì lỗi thường nằm giữa gateway và upstream. Nếu phải xóa dữ liệu, chỉ xóa dữ liệu của website liên quan và lưu ý bạn có thể bị đăng xuất.

Cách chẩn đoán 502 cho quản trị website

Bước 1: Ghi lại request thất bại

Thu thập thời điểm có múi giờ, URL, phương thức HTTP, request ID, mã ray nếu dùng CDN, vùng xảy ra lỗi và tần suất. Một lỗi liên tục khác hoàn toàn lỗi chỉ xuất hiện ở một phần trăm request.

Kiểm tra header bằng cURL:

curl -I https://example.com/

Xem chi tiết quá trình kết nối:

curl -v https://example.com/

Đầu ra verbose có thể chứa header hoặc cookie nhạy cảm. Chỉ chia sẻ bản đã che dữ liệu xác thực.

Bước 2: Kiểm tra upstream trực tiếp trong mạng được phép

Từ máy gateway hoặc môi trường quản trị, gọi health endpoint của backend bằng đúng giao thức, host và cổng. Nếu upstream trực tiếp cũng lỗi, tập trung vào ứng dụng. Nếu upstream tốt nhưng đường qua gateway lỗi, kiểm tra cấu hình proxy, TLS, DNS và header.

Không công khai cổng origin hoặc bỏ CDN trên DNS chỉ để thử, vì hành động đó có thể làm lộ hạ tầng. Dùng kết nối nội bộ, VPN quản trị hoặc phiên chẩn đoán đã được cấp quyền.

Bước 3: Đọc log gateway và ứng dụng cùng thời điểm

Nginx error log có thể chỉ ra “connection refused”, “upstream prematurely closed connection”, “no live upstreams” hoặc lỗi SSL. Sau đó đối chiếu log ứng dụng bằng cùng request ID. Nếu chỉ nhìn một phía, bạn dễ nhầm triệu chứng với nguyên nhân.

Bước 4: Xác minh tiến trình và tài nguyên

Kiểm tra service còn chạy, cổng có lắng nghe, container có restart, pod có ở trạng thái Ready và máy chủ có thiếu CPU, RAM, disk hay file descriptor không. Với autoscaling, kiểm tra cả tốc độ scale và thời gian warm-up.

Bước 5: So sánh với thay đổi gần nhất

Đối chiếu thời điểm lỗi với deploy, đổi DNS, xoay chứng chỉ, sửa firewall, nâng phiên bản runtime hoặc thay cấu hình proxy. Nếu rollback là quy trình đã được chuẩn bị và kiểm thử, đây có thể là cách khôi phục nhanh trong khi nhóm tiếp tục tìm nguyên nhân.

Sửa lỗi 502 Bad Gateway trên Nginx

Một cấu hình reverse proxy tối giản có thể như sau:

location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_connect_timeout 5s;
    proxy_read_timeout 60s;
}

Hãy kiểm tra bốn điểm: ứng dụng có thực sự nghe ở 127.0.0.1:3000; giao thức là HTTP hay HTTPS; đường dẫn proxy_pass có tạo URL đúng; và Nginx có quyền kết nối socket/cổng đó hay không.

Trước khi reload, luôn kiểm tra cú pháp:

nginx -t

Nếu dùng systemd và có quyền quản trị máy chủ, xem trạng thái dịch vụ cùng journal theo quy trình nội bộ. Không nên sao chép lệnh restart hàng loạt khi chưa biết service nào lỗi.

Có nên tăng proxy_read_timeout?

Chỉ nên tăng khi backend hợp lệ nhưng cần nhiều thời gian cho một tác vụ đã biết, chẳng hạn xuất báo cáo lớn. Nếu ứng dụng đang deadlock, truy vấn database chậm hoặc queue tắc, tăng timeout chỉ khiến request chờ lâu hơn và giữ thêm tài nguyên.

Theo tài liệu Nginx, proxy_connect_timeout kiểm soát thời gian thiết lập kết nối tới upstream, còn proxy_read_timeout áp dụng giữa các lần đọc liên tiếp từ upstream. Hai giá trị không thay thế nhau.

Header quá lớn hoặc buffer không phù hợp

Cookie hoặc header phản hồi lớn có thể gây lỗi liên quan buffer. Đừng tăng buffer ngay khi chưa đọc chính xác log. Trước hết, giảm dữ liệu không cần thiết và sửa ứng dụng phát header bất thường; sau đó mới điều chỉnh buffer có đo lường.

Lỗi 502 trên Docker và Kubernetes

Trong Docker Compose, dùng tên service của backend thay cho 127.0.0.1 nếu Nginx và ứng dụng ở hai container khác nhau. Đồng thời xác minh chúng nằm cùng network và ứng dụng lắng nghe trên 0.0.0.0, không chỉ loopback bên trong container.

Với Kubernetes, kiểm tra theo chuỗi Ingress → Service → EndpointSlice/Endpoints → Pod. Service có selector sai sẽ không có endpoint. Pod chạy nhưng chưa Ready cũng có thể bị loại khỏi lưu lượng. Health check cần phản ánh trạng thái sẵn sàng phục vụ, nhưng không nên phụ thuộc vào quá nhiều dịch vụ phụ khiến toàn bộ pool bị loại chỉ vì một thành phần không thiết yếu.

Khi pod liên tục restart, xem reason, exit code, sự kiện và log lần chạy trước. Nếu lỗi do OOMKilled, cần vừa điều chỉnh tài nguyên vừa tìm nguyên nhân dùng bộ nhớ.

Sửa lỗi 502 khi dùng Cloudflare hoặc CDN

Đầu tiên, xác định trang lỗi do CDN tạo hay do origin chuyển lên. Lưu ray/request ID, thời điểm và URL. Tiếp theo, kiểm tra origin từ môi trường được ủy quyền bằng đúng Host và SNI. Một request gửi thẳng IP nhưng thiếu hostname có thể cho kết quả sai.

Kiểm tra chứng chỉ origin, cổng được CDN hỗ trợ, firewall allowlist, thời gian phản hồi và tính hợp lệ của nội dung nén. Nếu lỗi chỉ xuất hiện một vùng, cung cấp traceroute hoặc dữ liệu chẩn đoán theo hướng dẫn của nhà cung cấp, đồng thời tránh đăng công khai IP origin và header bí mật.

Lỗi 502 khi gọi API: có nên retry?

Client API có thể retry lỗi 502, nhưng cần giới hạn số lần và dùng exponential backoff kèm jitter. Chỉ tự động retry thao tác an toàn hoặc idempotent như GET, HEAD, PUT được thiết kế đúng, hoặc request có idempotency key.

Không retry POST thanh toán, tạo đơn hoặc gửi biểu mẫu một cách mù quáng. Gateway có thể trả 502 sau khi backend đã nhận và xử lý request nhưng phản hồi bị mất. Khi đó retry tạo dữ liệu trùng. Thiết kế idempotency và truy vấn trạng thái giao dịch là giải pháp an toàn hơn.

Proxy có thể gây lỗi 502 không?

Có. Forward proxy của doanh nghiệp hoặc dịch vụ trung gian cũng là gateway. Nó có thể trả 502 khi không kết nối được website đích, DNS sai, xác thực upstream lỗi hoặc kết nối TLS bị gián đoạn.

Để khoanh vùng, thử request không qua proxy trong môi trường được phép, sau đó kiểm tra endpoint bằng Proxy Checker. Nếu cần tự động thử nhiều endpoint trong tác vụ hợp pháp, bài cách xoay proxy trong Python trình bày cách quản lý danh sách và lỗi kết nối. Bạn cũng nên phân biệt proxy và VPN vì hai lớp này ảnh hưởng đường truyền theo cách khác nhau.

Khi chọn hạ tầng proxy cho công việc, hãy đánh giá uptime, giao thức, vị trí, cơ chế xác thực và hỗ trợ kỹ thuật thay vì chỉ nhìn giá. Có thể xem các lựa chọn trên Proxify và đọc thêm proxy dùng để làm gì trước khi cấu hình.

Cách phòng ngừa lỗi 502

Hệ thống nên có health check đúng nghĩa, readiness probe, timeout theo từng lớp và graceful shutdown để instance ngừng nhận request trước khi thoát. Khi deploy, rolling update cần giữ đủ instance khỏe và cho ứng dụng thời gian khởi động.

Giám sát không chỉ tỷ lệ 502 mà còn latency upstream, số kết nối, hàng đợi, CPU, RAM, connection pool và lỗi dependency. Cảnh báo nên gắn với tác động thực tế, chẳng hạn tỷ lệ lỗi theo route hoặc khu vực, thay vì một request đơn lẻ.

Log có cấu trúc và request ID xuyên suốt CDN, gateway, ứng dụng giúp rút ngắn thời gian tìm lỗi. Với tác vụ dài, cân nhắc chuyển sang hàng đợi bất đồng bộ và trả trạng thái theo job thay vì giữ kết nối HTTP quá lâu.

Cuối cùng, chạy thử cấu hình trước deploy, kiểm tra chứng chỉ tự động, diễn tập rollback và lập runbook. Một runbook tốt ghi rõ dashboard, vị trí log, cách xác minh upstream, người phụ trách và điều kiện rollback.

Câu hỏi thường gặp về lỗi 502 Bad Gateway

Lỗi 502 có phải do máy tính của tôi không?

Phần lớn 502 phát sinh ở gateway hoặc upstream của website. Tuy nhiên, proxy doanh nghiệp, VPN, DNS hoặc extension cục bộ cũng có thể ảnh hưởng. Thử mạng và trình duyệt khác giúp khoanh vùng.

502 Bad Gateway có tự hết không?

Có thể nếu nguyên nhân là deploy ngắn, restart hoặc quá tải tạm thời. Nếu lỗi kéo dài, quản trị viên cần kiểm tra log và upstream; chờ đợi không sửa được cấu hình sai.

Xóa cache có sửa lỗi 502 không?

Thường không, vì 502 là lỗi giữa các máy chủ. Làm mới trang hoặc thử cửa sổ riêng tư đủ để loại trừ phần lớn vấn đề cục bộ.

Lỗi 502 và 504 khác nhau thế nào?

502 nghĩa là gateway nhận phản hồi upstream không hợp lệ. 504 nghĩa là gateway không nhận được phản hồi kịp thời. Log thực tế vẫn cần thiết để phân biệt nguyên nhân gốc.

Vì sao Nginx báo 502 dù backend vẫn chạy?

Tiến trình chạy không có nghĩa là phục vụ đúng cổng. Có thể Nginx dùng sai host, giao thức hoặc socket; backend chưa sẵn sàng; firewall chặn; TLS lỗi; hoặc ứng dụng đóng kết nối trước khi gửi header.

Có nên restart máy chủ ngay không?

Không nên coi restart là bước đầu tiên. Trước hết hãy lưu log, chỉ số và trạng thái để tránh mất bằng chứng. Chỉ restart service cụ thể theo runbook khi đã xác định phạm vi và tác động.

Kết luận

502 Bad Gateway cho biết mắt xích gateway đã nhận phản hồi không hợp lệ từ upstream. Người truy cập nên thử lại có kiểm soát và báo lỗi với đầy đủ thời điểm, URL. Chủ website nên kiểm tra tuần tự từ request, gateway, DNS, cổng, TLS đến ứng dụng và tài nguyên.

Phương pháp hiệu quả nhất là đối chiếu log hai phía và tái hiện bằng request tối thiểu. Đừng tăng timeout hoặc restart hàng loạt theo phỏng đoán. Khi hệ thống có health check, request ID, giám sát upstream và quy trình deploy an toàn, lỗi 502 sẽ dễ phát hiện và khắc phục hơn nhiều.

© 2026 Proxify.vn. All rights reserved.

Bảo mật · An toàn · Tự động