Giới thiệu

Mỗi khi mở một site lên, trình duyệt sẽ gửi nhiều request tới nhiều web server. Các web server sau đó sẽ xử lý những request này và gửi về status code HTTP cùng với dữ liệu được yêu cầu. Thông thường HTTP status code không hiển thị trừ khi có lỗi xảy ra. Đây là các server thông báo với nhau để end-user biết có gì đó không ổn.

502 bad gateway là một trong các HTTP status codes xảy ra trong suốt qua trình dựng web của bạn. Mặc dù không thường xuyên như lỗi 500 internal server error hoặc 503 service unavailable error, nó vẫn có thể khiến bạn đau đầu. Vì vậy, bài hướng dẫn này tập trung tìm nguyên do và sửa lỗi 502 bad gateway error.

502 Bad Gateway là gì?

HTTP status codes bắt đầu bằng số “5” liên quan đến lỗi giao tiếp giữa các server. Mặc dù chính xác lỗi là gì còn tùy trường hợp, nhưng thường nó liên quan nhiều đến phía server hơn.

Gặp lỗi 502 bad gateway có nghĩa là server gốc gửi phản hồi không hợp lệ tới server khác ở giữa như là gateway và proxy. Vì tất cả request trên web đều được chuyển đi qua nhiều gateway, nên có thể rất khó để biết chính xác lỗi này nằm ở đâu hoặc process nào gây lỗi. Tuy nhiên, vẫn có vài cách bạn thể tham khảo để sửa:

Lỗi 502 bad gateway error có thể có nhiều mã lỗi khác nhau. Sau đây là các lỗi bạn có thể gặp:

Làm thế nào để sửa lỗi 502 Bad Gateway Error

Mặc dù lỗi 502 bad gateway thường liên quan đến server,  nhiều khi bạn cũng sẽ thấy hiện lỗi 502 bad gateway nginx, nó cũng có thể bắt nguồn từ việc cấu hình sai hoặc vấn đề từ phía client. Vì vậy, chúng tôi sẽ chỉ một số bước cơ bản để xử lý 2 trường hợp này. Mặc dù lấy ví dụ từ mã nguồn WordPress, nhưng bạn cũng có thể áp dụng tương tự cho các script khác:

1. Tải lại trang

Cách đầu tiên có thể là cách đơn giản nhất. Đợi 1 hoặc 2 phút rồi tải lại trang là xong. Trong một số trường hợp, lỗi này là tạm thời và chỉ cần F5, refresh là trang sẽ hoạt động lại bình thường. Trong thời gian đó, bạn cũng có thể kiểm tra xem website này có bị down hay không bằng các công cụ online.

2. Xóa Browser Cache

Nếu lỗi vẫn còn, và website không đang bị down thì có khả năng là cache trình duyệt của bạn gây ra lỗi. Sửa lỗi 502 bad gateway nginx này bằng cách xóa cách trình duyệt là xong.

3. Thử với trình duyệt khác

Kiểm tra thử lại website bằng một trình duyệt khác hoặc trong mode incognito. Nó sẽ cho bạn xem lỗi có phải nằm ở phía trình duyệt hay không.

4. Flush DNS

502 bad gateway error cũng có thể do vấn đề liên quan đến DNS, như là địa chỉ IP bị cached không đúng giá trị. Vậy để sửa lỗi bạn flush DNS. Đây là bài hướng dẫn làm thế nào để flush DNS trên Windows, Mac, và Linux.

Bạn cũng có thể thử dùng DNS khác thay vì DNS mặc định như dùng  Google Public DNS.

5. Thử trên thiết bị khác

Nếu không có cách nào ở trên giúp bạn loại bỏ lỗi 502 bad gateway hiện lên màn hình, hãy thử kiểm thử lại trên một máy tính khác hoặc trên điện thoại, tốt nhất là dùng hẵn một đường mạng khác như đường mạng 3G/4G. Đây là bước cuối cùng để kiểm thử xem lỗi có phải do phía máy bạn hay không.

6. Kiểm lại error log

Nếu error 502 hay lỗi 502 hiện lên vì thay đổi hoặc cập nhật nào đó, có thể đó chính là nguyên nhân gây lỗi, bản cập nhật của website đã gây lỗi. Vì vậy có thể bạn cần mở error log để tìm thêm manh mối. Trong WordPress, bạn có thể kích hoạt error logging bằng cách thêm dòng sau vào trong wp-config.php:

Tất cả các entries lỗi sẽ xuất hiện trong file wp-contents/debug.log.

7. Kiểm tra lại Plugins

Có thể nói bước này khá quan trọng, kiểm tra lại plugins và extensions. Các lỗi gây ra bởi caching plugin có thể dẫn đến error 502 hay 502 bad gateway hiện lên. Cách đơn giản nhất nhất để xác nhận điều này là vô hiệu toàn bộ plugins trong thời gian ngắn. Để làm vậy, di chuyển tới thư mục wp-content rồi đổi tên thư mục plugins.

Nếu website hoạt động lại sau  khi toàn bộ plugin bị vô hiệu, thì tức là một trong các plugin đã gây lỗi, bạn có thể đổi tên thư mục thành plugins như ban đầu. Sau đó thử vô hiệu từng plugin một để xác định chính xác plugin nào gây lỗi.

8. Kiểm tra lại CDNs

Một nguyên nhân khác gây lỗi 502 bad gateway nginx là do CDNs hoặc DDoS mitigation services. Một ví dụ điển hình là CloudFlare, lỗi 502 bad gateway có thể xảy ra giữa 2 phiên bản gặp xung đột gì đó, tùy thuộc vào từng trường hợp.

Màn hình này thể hiện lỗi trên phía CloudFlare, để sửa lỗi thì bạn cần liên hệ với đội hỗ trợ của CloudFlare. Ngoài ra bạn cũng có thể vô hiệu CloudFlare, mặc dù phải nhớ là DNS propagation có thể mất vài giờ để hoàn tất.

Tuy nhiên, nếu bạn nhìn thấy lỗi trên, có nghĩa là lỗi nằm ở phía nhà cung cấp hosting.

9. Liên hệ đội ngũ hỗ trợ kỹ thuật

Nếu không có giải pháp nào ở trên sửa được lỗi 502 bad gateway error, vậy tốt nhất là liên hệ lại với đội ngũ hỗ trợ của bạn. Trong quá trình mô tả lỗi, hãy mô tả kỹ các bước trước khi gây lỗi, và cung cấp cho họ thấy bạn đã làm gì để sửa lỗi. Việc cung cấp càng nhiều thông tin cần thiết, lỗi sẽ nhanh chóng được xử lý hơn!

Lời kết

Trong bài hướng dẫn này, chúng ta đã được biết về lỗi 502 bad gateway error là gì và làm thế nào để sửa nó với các cách đơn giản nhưng hữu hiệu.

Nếu bạn có thêm thủ thuật nào khác, hay giải pháp nào cho vấn đề này, hãy chia sẽ với mọi người bằng cách để lại bình luận bên dưới nhé.!