Lỗi 502 Bad Gateway: Nguyên nhân và cách khắc phục

Khi truy cập website, bạn có thể bất ngờ thấy thông báo “502 Bad Gateway” thay vì nội dung cần xem. Lỗi này không chỉ làm gián đoạn trải nghiệm của khách truy cập mà còn ảnh hưởng đến hoạt động kinh doanh nếu kéo dài. Tuy vậy, 502 thường có thể được khoanh vùng bằng cách kiểm tra các máy chủ trung gian, dịch vụ web, ứng dụng và nhật ký lỗi.

Bài viết dưới đây giải thích lỗi 502 Bad Gateway là gì, chỉ ra những nguyên nhân thường gặp và hướng dẫn cách sửa lỗi 502 trên hosting hoặc VPS. Bạn có thể thực hiện lần lượt từ bước kiểm tra đơn giản đến việc xem log và kiểm tra cấu hình máy chủ.

Lỗi 502 Bad Gateway là gì?

Lỗi 502 Bad Gateway là mã trạng thái HTTP cho biết một máy chủ đóng vai trò cổng trung gian hoặc proxy đã nhận được phản hồi không hợp lệ từ máy chủ phía sau. Nói đơn giản, trình duyệt gửi yêu cầu đến website, nhưng một thành phần trung gian như Nginx, proxy hoặc CDN không nhận được phản hồi phù hợp từ máy chủ ứng dụng.

Một hệ thống website có thể gồm nhiều lớp: trình duyệt, dịch vụ proxy hoặc web server, rồi đến ứng dụng như WordPress và PHP-FPM. Nếu một lớp không thể kết nối với lớp tiếp theo, hoặc nhận phản hồi sai định dạng, website có thể trả về lỗi 502. Trang lỗi đôi khi do hosting, máy chủ, proxy hoặc CDN hiển thị nên giao diện không giống nhau giữa các website.

502 không đồng nghĩa với việc website đã bị mất dữ liệu hay bị tấn công. Đây là dấu hiệu cần kiểm tra luồng xử lý yêu cầu. Nếu lỗi chỉ xuất hiện trong thời gian ngắn, có thể máy chủ vừa quá tải hoặc dịch vụ đang khởi động lại. Nếu lỗi lặp lại, cần tìm nguyên nhân ở ứng dụng, cấu hình hoặc tài nguyên máy chủ.

Nguyên nhân lỗi 502 thường gặp

Một số nguyên nhân lỗi 502 phổ biến gồm:

• Máy chủ ứng dụng không phản hồi: Dịch vụ web, PHP-FPM hoặc tiến trình xử lý ứng dụng bị dừng, treo hay khởi động lại.
• Máy chủ quá tải: CPU, RAM hoặc số lượng kết nối đã chạm giới hạn, khiến yêu cầu không được xử lý kịp thời.
• Cấu hình proxy sai: Nginx hoặc proxy chuyển yêu cầu đến sai địa chỉ, cổng hoặc socket của máy chủ phía sau.
• Ứng dụng phát sinh lỗi: Plugin, theme, mã nguồn hoặc một tác vụ nặng khiến ứng dụng bị lỗi khi xử lý yêu cầu.
• Giới hạn thời gian kết nối: Máy chủ trung gian chờ quá lâu nhưng không nhận được phản hồi từ ứng dụng.
• Sự cố mạng hoặc DNS giữa các lớp: Các thành phần trong hệ thống không kết nối được với nhau, dù người dùng vẫn truy cập được máy chủ ở một số thời điểm.
• Thay đổi cấu hình chưa phù hợp: Cập nhật web server, PHP hoặc cài đặt proxy có thể làm sai thông số kết nối.

Một nguyên nhân không nhất thiết chỉ tạo ra một loại lỗi. Chẳng hạn, quá tải thường gây phản hồi chậm hoặc hết thời gian chờ, nhưng trong một số cấu hình cũng có thể dẫn đến 502. Vì vậy, hãy đối chiếu thời điểm lỗi với log và tình trạng dịch vụ thay vì chỉ suy đoán theo thông báo trên trình duyệt.

Cách kiểm tra lỗi 502 trước khi chỉnh sửa

Trước tiên, xác định lỗi xảy ra với toàn bộ website hay chỉ một trang, một mạng hoặc một thiết bị. Thử mở website bằng trình duyệt khác, mạng khác hoặc thiết bị khác. Nếu chỉ một máy gặp lỗi, hãy xóa bộ nhớ đệm và kiểm tra lại kết nối. Nếu nhiều người cùng gặp lỗi, khả năng cao vấn đề nằm ở máy chủ hoặc ứng dụng.

Tiếp theo, ghi lại thời điểm xảy ra lỗi, URL bị ảnh hưởng và thao tác vừa thực hiện trước đó, chẳng hạn cập nhật plugin, sửa cấu hình hay triển khai mã nguồn. Thông tin này giúp đối chiếu log chính xác hơn. Nếu website dùng proxy hoặc CDN, hãy kiểm tra trạng thái kết nối giữa proxy và máy chủ gốc; chỉ tạm thời bỏ qua lớp trung gian khi bạn hiểu rõ cấu hình và có quyền thực hiện.

Trên hosting, hãy đăng nhập bảng điều khiển và xem thông báo sử dụng tài nguyên, trạng thái dịch vụ, lịch sử lỗi hoặc mục nhật ký. Tên và vị trí các chức năng tùy thuộc hệ thống quản trị. Nếu không có quyền xem log máy chủ, hãy gửi thời điểm xảy ra lỗi, tên miền và đường dẫn bị ảnh hưởng cho đơn vị hỗ trợ hosting.

Trên VPS, kiểm tra trước các dịch vụ liên quan và mức sử dụng tài nguyên. Với hệ thống Linux dùng systemd, có thể xem trạng thái dịch vụ bằng lệnh systemctl status nginx, systemctl status apache2 hoặc tên dịch vụ PHP-FPM đang cài đặt. Tên dịch vụ có thể khác theo hệ điều hành và phiên bản. Xem nhật ký hệ thống bằng journalctl -u ten-dich-vu --since '30 minutes ago'; thay ten-dich-vu bằng dịch vụ cần kiểm tra.

Đọc log của web server và ứng dụng quanh thời điểm lỗi. Nginx thường có error log, còn Apache thường ghi lỗi vào error log; vị trí tệp phụ thuộc cấu hình máy chủ. Tìm các thông báo như upstream timed out, connection refused, không thể kết nối tới socket hoặc upstream trả phản hồi không hợp lệ. Không đăng công khai log vì chúng có thể chứa đường dẫn, địa chỉ IP hoặc thông tin nhạy cảm.

Cách sửa lỗi 502 trên hosting

Nếu website chạy trên hosting, hãy bắt đầu với những thao tác ít rủi ro:

1. Kiểm tra trạng thái website và tài nguyên: Xem bảng điều khiển có cảnh báo vượt giới hạn CPU, RAM, tiến trình hoặc dung lượng hay không. Nếu có, tìm tác vụ gây tải cao và xử lý thay vì chỉ thử tải lại trang.
2. Đối chiếu thay đổi gần đây: Nếu lỗi bắt đầu sau khi cài plugin, cập nhật theme hoặc chỉnh sửa mã nguồn, hãy hoàn tác thay đổi gần nhất nếu có bản sao lưu và bạn biết cách khôi phục an toàn.
3. Tạm kiểm tra plugin hoặc ứng dụng: Với WordPress, nếu có quyền quản trị, thử tắt plugin mới cài hoặc cập nhật gần đây. Nếu không vào được trang quản trị, việc đổi tên thư mục plugin qua trình quản lý tệp có thể làm chúng ngừng hoạt động; chỉ thực hiện khi đã sao lưu và hiểu rằng thao tác này ảnh hưởng toàn bộ plugin trong thư mục đó.
4. Kiểm tra cấu hình website: Xác minh phiên bản PHP và các thiết lập ứng dụng tương thích với mã nguồn. Tránh thay đổi đồng thời nhiều thông số vì sẽ khó xác định yếu tố gây lỗi.
5. Liên hệ bộ phận hỗ trợ: Nếu không xem được log máy chủ hoặc lỗi liên quan đến tiến trình web, gửi thời gian xảy ra, URL và các thay đổi gần đây để đội ngũ hỗ trợ kiểm tra phía hosting.

Không nên xóa tệp cấu hình, tăng giới hạn tùy tiện hoặc cài lại website chỉ dựa trên trang báo lỗi. Các thao tác này có thể làm phát sinh lỗi mới, ảnh hưởng dữ liệu hoặc che khuất nguyên nhân ban đầu. Nếu hosting có chức năng sao lưu, hãy kiểm tra bản sao lưu trước khi khôi phục.

Cách sửa lỗi 502 trên VPS

Với VPS, bạn có thể kiểm tra sâu hơn nhưng cần thận trọng vì cấu hình sai có thể khiến website ngừng hoạt động. Hãy sao lưu tệp cấu hình trước khi chỉnh sửa và thực hiện từng thay đổi một.

Kiểm tra dịch vụ và tài nguyên: Dùng systemctl status để kiểm tra Nginx hoặc Apache và dịch vụ PHP-FPM. Nếu dịch vụ dừng, đọc log để tìm nguyên nhân rồi mới khởi động lại bằng systemctl restart ten-dich-vu. Khởi động lại có thể giúp dịch vụ phục hồi tạm thời, nhưng không thay thế việc tìm lỗi gốc. Dùng free -h để xem bộ nhớ, df -h để kiểm tra dung lượng đĩa và top hoặc htop để quan sát tiến trình tiêu thụ tài nguyên.

Kiểm tra kết nối đến upstream: Nếu Nginx chuyển yêu cầu đến PHP-FPM qua cổng hoặc Unix socket, hãy xác nhận dịch vụ PHP-FPM đang chạy và địa chỉ trong cấu hình Nginx trùng với địa chỉ dịch vụ thực tế. Với ứng dụng chạy trên cổng riêng, kiểm tra tiến trình có đang lắng nghe đúng cổng hay không. Lỗi connection refused thường gợi ý dịch vụ đích không hoạt động hoặc địa chỉ kết nối không đúng.

Kiểm tra và áp dụng cấu hình an toàn: Sau khi chỉnh cấu hình Nginx, chạy nginx -t để kiểm tra cú pháp. Chỉ tải lại dịch vụ nếu kiểm tra thành công, ví dụ systemctl reload nginx. Với Apache, dùng công cụ kiểm tra cấu hình tương ứng của hệ điều hành trước khi tải lại. Không sao chép cấu hình từ nguồn không rõ hoặc đổi cổng, socket khi chưa xác nhận thiết lập của ứng dụng.

Kiểm tra thời gian chờ và ứng dụng: Nếu log cho thấy upstream phản hồi chậm, xác định yêu cầu nào mất nhiều thời gian, kiểm tra truy vấn cơ sở dữ liệu, tác vụ nền hoặc mã nguồn tốn tài nguyên. Chỉ điều chỉnh timeout khi đã xác định ứng dụng cần thêm thời gian và máy chủ có đủ khả năng xử lý. Tăng timeout không giải quyết được tình trạng ứng dụng treo hay quá tải.

Nếu lỗi bắt đầu sau một lần triển khai, so sánh cấu hình và phiên bản mới với bản đang hoạt động trước đó. Khi cần hoàn tác, dùng quy trình triển khai hoặc bản sao lưu đã kiểm tra. Tránh khởi động lại toàn bộ VPS như bước đầu tiên vì việc này có thể làm gián đoạn các dịch vụ khác và khiến log về nguyên nhân bị mất dấu.

Sau khi khắc phục, cần kiểm tra gì?

Khi website hoạt động trở lại, truy cập các trang từng báo lỗi và thử một số chức năng quan trọng như đăng nhập, gửi biểu mẫu hoặc thêm sản phẩm vào giỏ hàng nếu có. Theo dõi log trong một khoảng thời gian để xác nhận lỗi không tái diễn. Nếu nguyên nhân là tài nguyên hoặc ứng dụng xử lý chậm, hãy cân nhắc tối ưu mã nguồn, cơ sở dữ liệu và tác vụ nền, đồng thời theo dõi mức sử dụng máy chủ.

Nếu website thường xuyên vượt khả năng của môi trường hiện tại, bạn có thể trao đổi với đơn vị cung cấp dịch vụ để đánh giá phương án phù hợp. VibeVPS có các gói VPS AMD EPYC Gen 3 và VPS Platinum Gen 2 từ 81.000đ/tháng; hãy đối chiếu nhu cầu tài nguyên và cách vận hành website trước khi lựa chọn. Việc chuyển sang VPS không tự động sửa lỗi ứng dụng hoặc cấu hình, nên cần chuẩn bị kế hoạch chuyển đổi và kiểm tra sau khi triển khai.

Kết luận

Lỗi 502 Bad Gateway cho biết một máy chủ trung gian không nhận được phản hồi hợp lệ từ máy chủ phía sau. Để tìm đúng nguyên nhân, hãy xác định phạm vi ảnh hưởng, kiểm tra tài nguyên và dịch vụ, rồi đối chiếu log trước khi thay đổi cấu hình. Trên hosting, bạn có thể bắt đầu từ bảng điều khiển và nhờ bộ phận hỗ trợ kiểm tra phía máy chủ; trên VPS, hãy kiểm tra web server, PHP-FPM, upstream và cấu hình một cách có sao lưu.

Nếu lỗi vẫn tái diễn hoặc bạn chưa rõ cách đọc log, hãy trao đổi với đội ngũ kỹ thuật để được hỗ trợ khoanh vùng. VibeVPS có các lựa chọn hosting và VPS cho nhiều nhu cầu; bạn có thể tìm hiểu thêm để chọn môi trường phù hợp với website của mình.