500 Internal Server Error

Meaning & Description

Common Causes

• Unhandled programming exceptions in backend logic.
• Database connection failures or query timeouts.
• Permission issues on the server filesystem (e.g., cannot read a required config file).
• Syntax errors in server configuration files (like Nginx, Apache, or Docker).

How to fix a 500 error

1. Check the server application logs (e.g., PM2, Docker logs, or systemd journal) for stack traces matching the timestamp of the request.
2. Verify that all environment variables and secrets are correctly configured and accessible.
3. Ensure the database and other internal microservices are up and running.
4. Review recent code deployments or infrastructure changes that might have introduced a bug.

Browser & SEO Behaviour

Code Examples

HTTP/1.1 500 Internal Server Error
Content-Type: application/json

{
  "error": "Internal Server Error",
  "message": "An unexpected error occurred"
}

app.get("/data", async (req, res) => {
  try {
    throw new Error("Simulated crash");
  } catch (error) {
    console.error("Unhandled error:", error);
    res.status(500).json({
      error: "Internal Server Error",
      message: "An unexpected condition was encountered"
    });
  }
});

from fastapi import FastAPI, HTTPException

app = FastAPI()

@app.get("/data")
def get_data():
    try:
        1 / 0  # Causes ZeroDivisionError
    except Exception as e:
        raise HTTPException(status_code=500, detail="An unexpected error occurred on the server.")

package main

import (
	"net/http"
)

func handler(w http.ResponseWriter, r *http.Request) {
	http.Error(w, "500 - Internal Server Error", http.StatusInternalServerError)
}

func main() {
	http.HandleFunc("/", handler)
	http.ListenAndServe(":8080", nil)
}

[HttpGet("data")]
public IActionResult GetData()
{
    try
    {
        // Simulate an unhandled exception
        throw new InvalidOperationException("Critical failure");
    }
    catch (Exception ex)
    {
        // Log the exception
        return StatusCode(500, new { error = "Internal Server Error" });
    }
}

# Testing a fallback error endpoint
curl -i -X GET https://api.example.com/crash

Raw HTTP Response Example

HTTP/1.1 500 Internal Server Error
Content-Type: application/json
Connection: close

{
  "error": "Internal Server Error",
  "reference_id": "err_123456789"
}

Real-world Examples

Frequently Asked Questions

Developer Tips

• Never expose stack traces in production 500 responses. This is a major security risk that can reveal your internal architecture to attackers.
• Implement a global exception handler in your application to catch unhandled errors, log them with a unique ID, and return a sanitized 500 response with that ID to the user.
• Use logging and monitoring tools like Sentry or Datadog to instantly alert your team when a spike in 500 errors occurs.

Interview Questions

These are questions you might face in a backend or API design interview that touch on HTTP 500.