Whitelabel Error Page ☕ Java

Whitelabel Error Page — This application has no explicit mapping for /error

Spring Boot’s default error page — the request hit no controller mapping (404) or a controller threw (500).

Seen on: Java

Meaning

The status line under the heading tells you which: 404 means no handler mapped that path (wrong URL, controller not scanned, @Controller vs @RestController); 500 means an exception — check the logs.

Common causes

  • No controller for the path / wrong HTTP method
  • Controller outside the component-scan package
  • @Controller returning a view name that doesn’t exist
  • Exception in the handler (status 500)

⚡ Quick fix

  1. Check the status shown on the page
  2. Verify @RequestMapping paths and package location
  3. Use @RestController for JSON APIs
  4. Read the server log for 500s

Detailed fix by platform

Java

  1. Add server.error.include-message=always temporarily in dev to see details

How to diagnose

  1. Status — 404 or 500?
  2. Mapping — Does a handler match path + method?

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.