What are server error status codes?

The server made a mistake

Imagine you walk into a restaurant and place your order perfectly: correct item, correct table, valid payment. But then the kitchen catches fire. That's not your fault as a customer; the restaurant can't fulfill your request right now.

That's what 5xx status codes represent in HTTP. The client did everything right, but the server encountered a problem and couldn't complete the request.

What makes 5xx different from 4xx?

With 4xx errors, the client is at fault: a bad URL, missing authentication, invalid data. With 5xx errors, the server is at fault: it crashed, timed out, or hit an unexpected condition.

Client Request (valid) ──→ Server (broken) ──→ 5xx Response

"I did my part correctly,     "Something went wrong
 but something broke            on our end."
 on the server side."

This distinction matters because:

• 4xx: The client should fix the request and retry
• 5xx: The server team needs to investigate and fix the issue

The 5xx family

Here are the most important server error codes you'll encounter:

In practice, you'll deal with 500, 502, 503, and 504 most frequently.

Why 5xx errors are critical

Unlike 4xx errors that affect individual users making bad requests, 5xx errors often affect all users at once:

5xx errors are high priority incidents because they mean your application is failing to serve users who are doing nothing wrong.

The role of infrastructure

Modern web applications have multiple layers between the user and your code:

User ──→ CDN ──→ Reverse proxy ──→ App server ──→ Your app ──→ Database
                  (Nginx)          (Puma)          (Rails)      (PostgreSQL)

A 5xx error can originate at any layer:

Knowing which layer caused the error is the first step in debugging.

5xx in development vs production

Rails handles 5xx errors very differently depending on the environment:

In development, seeing a 500 error gives you the full stack trace right in the browser. In production, you never expose internal details: instead, you log them and show a friendly error page.

Summary