502 Bad Gateway Error
Any 50x error means that some request to the server didn’t return a proper result. A 502 specifically means that there was a bad gateway. At WP Engine, this gateway usually refers to the relationship between NGINX and Apache.
On the WP Engine platform, the 502 Bad Gateway error typically signals an issue between the uncached PHP processing of the request and the request being served back to the browser. Servers have a specific number of PHP Workers available to process uncached requests at any given time. If a request being processed by a PHP Worker is rejected for taking too long to complete or cannot complete, this causes the 502 Bad Gateway error.
About 502 Errors
When a 502 occurs on WP Engine this is almost always one of two things:
- Instant 502 – The error message displays immediately after an action
- Sig terms, graceful restarts, and/or segmentation faults have occurred causing the connection to break. These can happen for a variety of reasons most commonly bad code, but can also include uncached request load, or too many process time-outs.
- Long 502 – The error message takes around 60 seconds to appear after an action
- The request was killed by the Apache-Long-Process-Killer after 60 seconds
Before diagnosing a 502 we advise checking your access logs to confirm the 502 seen in your browser was actually returned in the access logs and not a different error code. Access logs are located in the User Portal or WordPress, by the Error Logs.
Diagnose 502 Errors
You can use your site’s error logs to see if there have been any code errors which might explain the timeout, as well as killed queries. If these logs don’t help, you can start narrowing down root causes. For example, turning off all plugins and seeing if the error still exists will help you determine if the error is caused by a plugin or by your theme.
Combating 502 errors can be an art in itself. Since the causes of these errors can be deep in the code of a site and not easily identifiable, we highly recommend consulting with a developer. If you need help finding a developer, WP Engine has a list of recommended consultants you can reference.
If you need immediate help with 502 errors please contact Support via 24/7 chat in your User Portal.
We’ve put together a helpful workflow for diagnosing 502s:
Consistent 502 Errors
Is the 502 error instant? This is most likely due to a code issue.
- Try disabling plugins/setting a default theme then see if the issue persists.
Is the 502 error long (~60 seconds)? This is most likely due to a process is being killed by our server timeout.
- If you’re running an import/export, it will need to be reduced in size
- Try disabling plugins/setting a default theme then see if the issue persists.
- Query Monitor may be of assistance here in locating a slow/long query
502 Errors on Specific Pages
Try disabling plugins/setting a default theme one at a time to see if the issue persists.
502 Errors at Recurring Times
Cross-check the timing of the cron jobs that are receiving the 502 errors
- There may be crons running too long and using workers that could instead be broken up into smaller chunks.
Cross-check your traffic peaks times and review any cache exclusions you’ve requested via Support
- Traffic combined with a large number of uncached pages will overwork the server and cause more 502 evictions at times of high traffic.
Random 502 Errors
Your database may be the issue, try optimizing your database.
Is object caching enabled? Try disabling the object cache.
- If this works, leave object caching off until you can reduce your autoloaded data.
Prevent 502s
The best way to prevent issues with 502 Bad Gateway errors is to ensure your site is healthy. Following WordPress best practices for site health will help prevent code conflicts and keep your site secure.
Simple steps like updating your Plugins, Themes, and WordPress itself can help ensure site health. These updates should be tested in a staging or test environment first to prevent code conflicts on your production site.
Last, you should regularly audit your plugins and settings to delete anything unnecessary. Fewer installed plugins means a smaller codebase to maintain and fewer opportunities for code conflicts.
Disable Server Timeout
The 60-second timeout is in place to ensure our servers are able to serve the maximum amount of concurrent requests. Without a timeout in place, we’ve seen requests take minutes to even hours to complete. With the continued performance of your site in mind, we will not be able to disable the server timeout which may be causing your 502s. This timeout is programmed at the root of our platform. It is in place to ensure optimal server health, speed, and uptime.
NEXT STEP: Learn how to troubleshoot using the WP Engine SSH gateway
