One of probably the most irritating points of working an internet site is having to troubleshoot an error if you don’t know why it’s taking place. Some points, such as the 502 dangerous gateway error, have many potential causes. This means chances are you’ll attempt a number of options earlier than you land on the best one. In this put up we’ll present you the best way to navigate this difficult error and resolve it.

Let’s get to work!

What the 502 Bad Gateway Error Is (And Why It Happens)

The 502 dangerous gateway error pops up now and again and sometimes means there’s an issue together with your server.

When you go to an internet site, your browser sends a number of requests to the server that hosts the positioning. If all the things are working correctly, that server will ship again the data your browser requested, and the web site will load. On the opposite hand, the 502 dangerous gateway error happens when a server sends again an ‘invalid’ response. This can imply that the connection timed out, or maybe the results of a number of different points.

From the Mozilla Developer Network, the official definition is:

The HyperText Transfer Protocol (HTTP) 502 Bad Gateway server error response code signifies that the server, whereas appearing as a gateway or proxy, obtained an invalid response from the upstream server.

So far, this may increasingly sound easy. However, the connection between your browser and most web sites isn’t as simple because it was once. For instance, your browser’s request would possibly get routed by way of a proxy server earlier than making its method to the host in the query, so it may be laborious to pinpoint the place the difficulty is positioned. Plenty of web sites additionally use a number of servers, which complicates issues even additional since any of them might be the reason for the 502 error.

All of this implies there are a number of potential causes for this explicit error code. It might be the results of:

  • Errors in your database.
  • A server that’s timed out, at the moment unavailable, or simply not working as supposed.
  • The server is overloaded with too many requests. Perhaps a DDOS assault, and even only a larger-than-intended spike in visitors.
  • An issue together with your reverse proxy server.
  • Faulty PHP scripts, courtesy of certainly one of your plugins or themes.

The excellent news is that if the issue is server-side, chances are you’ll not take any motion. In these instances, your internet hosting supplier will normally soar to the rescue shortly (since purchasers have a tendency to not recognize downtime). You ought to make certain to contact your host’s assist staff as quickly as attainable after receiving the discover that your website is affected by a 502 error.

With that in thoughts, we’re going to give attention to what to do if the 502 dangerous gateway error doesn’t go away by itself shortly. Most web sites can’t afford to be down for hours at a time, in spite of everything, so if this error persists it’s time to begin troubleshooting in your finish.

How to Fix the 502 Bad Gateway Error

Before you shift into troubleshooting mode, there’s one fast check you possibly can run to find out in case your server is responding because it ought to. You can attempt running a traceroute, to see in case your server is reachable within the first place. If it’s, then the issue might be in your finish. If not, that is when chances are you’ll wish to get in contact together with your internet hosting supplier.

You must also attempt resetting your router, and check your Domain Name System (DNS) settings. These are primary fixes that may typically make the 502 error go away, they usually are straightforward sufficient to deal with by yourself. If you discover that neither resolution solves the issue, nonetheless, you need to use the next strategies to troubleshoot the 502 error.

Clear Your Browser Cache

The 502 error can seem if you attempt to enter your web site, even when the underlying downside has been resolved. This happens in case your browser is counting on its cache, fairly than loading the newest model of your website from the server.

Simply reloading the positioning a number of instances can usually do the trick. Especially for those who’re utilizing the Forced Reload by way of Shift-CTRL-R on Windows or Shift-CMD-R on Mac.

If all the above fails, you need to proceed to empty your browser’s cache manually. Chrome customers can do that by navigating to the Settings > Advanced menu, and finding the Clear Browsing Data possibility:

Clearing your browser's cache.

Look for the Cached Images and Files possibility underneath the Basic tab, and click on Clear Data after choosing it. Keep in thoughts that this menu can even delete your searching historical past, for those who don’t disable that setting earlier than clicking on the Clear Data button.

This identical course may also be accomplished utilizing Firefox, Safari, Internet Explorer, and nearly some other browser. When you’ve gotten cleared the cache, attempt reloading your web site as soon as extra. If the error persists, it’s time to get severe. For extra data on clearing the cache, yow will discover it over at Hubspot’s hub page on the topic.

Temporarily Disable Your Content Delivery Network (CDN)

Earlier, we talked about that your browser requests will typically be routed by way of a reverse proxy server. In different phrases, utilizing proxy server locations a middleman between the person’s browser and the web site’s server.

Some companies, similar to Content Delivery Networks (CDN), depend on reverse proxy expertise to route incoming visitors as effectively as attainable. However, typically this additional layer can create points if you’re making an attempt to connect with an internet site’s origin server. When that occurs, your guests (and also you) would possibly run throughout the dreaded 502 dangerous gateway error.

Fortunately, it’s straightforward sufficient to test and see in case your CDN is inflicting this difficulty. All you must do is briefly disable the service, after which check whether or not your web site hundreds accurately without it. The means of disabling your CDN will range relying on the service you’re utilizing, nevertheless, it’s normally easy.

For occasion, Cloudflare customers simply should navigate to the Overview tab of their dashboard. Inside, you’ll discover a listing of properties that can be working the service. Then you’ll search for the large Pause button within the Pause Website part, and click on on it:

Pausing your CDN service.

Now, if you attempt to enter your web site, its origin server will reply to the request with no middlemen getting in the best way. If the 502 error is gone, then your CDN was most likely the supply of the difficulty. In most instances, you’ll simply want to attend a number of hours earlier than re-enabling the service. Of course, make sure to test and make it possible for the error remains to be gone afterward.

If you’re utilizing one other CDN, you’ll want to take a look at its documentation for directions on the best way to briefly disable the service. However, in case your CDN seems to not be the issue, there’s yet one more repair you possibly can attempt.

Test WordPress Themes and Plugins

So far, we’ve talked about three potential causes behind the 502 error: your server, your browser, and intermediary companies similar to CDNs. That solely leaves one possibility for those who’re positive the issue is in your finish, and that’s your web site. If you might be working WordPress particularly, certainly one of your plugins or themes may be making an attempt to execute a script that your server can’t load accurately. This can lead to an invalid response when your browser sends a request, triggering the 502 error.

You can solely have one lively theme at a time, so you possibly can merely deactivate your present one and change to a default WordPress theme briefly, to see if that resolves the error. On the opposite hand, determining if a plugin is inflicting issues can take extra time, relying on what number of them are at the moment lively.

Since you don’t have entry to your dashboard in the meantime due to the error, you’ll disable your plugins and themes manually. Keep in thoughts that this course doesn’t contain deleting the plugins and themes, and reactivating them solely takes a second. So your web site’s performance shouldn’t be affected. Even so, you need to have a current backup prepared simply in case.

Then, open up the FTP consumer of your selection. We’re large followers of FileZilla, so we’ll be utilizing that as our instance. Log into your web site via FTP, and navigate to the public_html – wp-content – plugins folder. There needs to be a folder for every of your put in plugins inside – even people who aren’t lively:

Your WordPress plugin directory.

If you right-click on any of these folders, you’ll see a number of choices, together with one labeled Rename. Click on that now, and alter the title of the folder to one thing like disabled.pluginname:

A disabled WordPress plugin.

When you enter your web site now, WordPress gained to be capable of discovering that plugin, so it is going to load without it. If the plugin you simply deactivated was inflicting the 502 error, your web site ought to load accurately. Just to make sure, keep in mind to make use of the CTRL + F5 command (or the OS X equal) to pressure your browser to delete its cache earlier than reloading the positioning.

To keep away from confusion, you need to troubleshoot one plugin at a time. Change a folder’s title, attempt reloading your web site, and see if it’s nonetheless displaying the 502 error. If it’s, restores the folder’s authentic title. Repeat this course of with every folder till you’ve discovered one which’s inflicting the error, or till you’ve examined each plugin. You can use the identical course to check your lively theme, which can pressure WordPress to make use of certainly one of its default themes as an alternative.

If certainly one of your plugins or themes is inflicting the 502 error, you possibly can delete it altogether and search for a substitute. If it’s outdated, you too can attempt updating it, to see if that resolves the issue. In some instances, the issue script shall be patched shortly, so you possibly can at all times resume utilizing that plugin or theme in a while.

Other Quick (Potential) Fixes

Now, these above fixes are possible going to search out and repair the wrongdoer if the 502 error is being brought on by one thing in your finish and never the server. If it doesn’t go away, keep in mind that we recommend you contact your internet host to allow them to kind by way of the server and diagnose any points there.

That stated, you possibly can assist velocity up the method by performing a few fast checks.

The first of those checks being any logs your website may need saving. If it’s WordPress, there are a variety of how to see it. We have a stable write-up on utilizing these logs to enhance your website which may be of some assistance right here. WP websites working variations or larger are geared up with a Site Health software which you can test inside your admin dashboard, so ensure you see what it has to say.

You may make it possible for your browser’s cookies are clear. These are fully separate from the cache, and we don’t at all times wish to clear these out. If you retain any data saved in your browser, this can wipe it out. But those self-same cookies might also 502 the connection between you and people websites, so it may be a Catch-22. Either means, it’s fairly straightforward to clear the cookies in any major browser.

If your website simply stalls out, it may be that there’s one thing within the background that simply wants extra time to execute. You can enhance the execution time allowed by a WordPress website fairly just by modifying your features.php file. If you’re not on WP, you are able to do it by way of .htaccess or php.ini, too. This press has a pretty good guide on how to get this all done.

Finally, you possibly can test for DNS errors. By that, we imply that you simply moved hosts or modified to a distinct form of plan or server itself. You may need adjusted nameservers or any variety of issues that would go awry. DNS settings are very particular and vulnerable to misconfiguration. So go into your cPanel or dashboard, make it possible for all the things strains up between your host and your area registrar, and the settings in your web site itself. Sometimes a wire will get crossed or a single typo stops all the things in its tracks. A bit DNS proofreading can go a good distance right here.

And for those who’re actually enthusiastic about ensuring the DNS is okay in your finish, you possibly can fireplace up the terminal and flush your DNS cache manually.


Troubleshooting WordPress errors is usually simpler than you would possibly assume. Even points that have a whole lot of potential causes, such because the 502 dangerous gateway error, is nicely understood and documented. You may need to check out a number of options earlier than you land on one which works, however, the troubleshooting course shouldn’t take too long for those who observe the best directions.

If you run into the 502 dangerous gateway error in your web site and it doesn’t go away after a couple of minutes (or after a fast name to your host’s assist staff), chances are high the issue is in your finish. Just undergo the processes and methods we talked about above, and also you and your customers need to be again on your web site very quickly.

Have you ever run into the 502 dangerous gateway error on certainly one of your web sites? Share your experiences with us within the feedback part!

Article thumbnail picture by windwheel /