Why Implement "Something Went Wrong" Error Messages?

99.9% of visitors probably have zero clue how to diagnose the problem so it makes sense to have a _friendly_ message acknowledging something went wrong to reduce panic.

Behind the scenes there might be extensive logging & monitoring for engineers to triage the issue.

In many cases that page is a "catch all errors" page.

There are technically "infinite" different reasons it could be shown. For example a variable is unexpectedly undefined due to a bug in the code.

So the error message can't elaborate in detail exactly what's wrong or why it happened or what to do about it, or whether trying again will help or not, etc...

Behind the scenes (hopefully) the actual error is captured and logged for further inspection.

In other words the end user will see a generic and friendly error message but behind the scenes the developers will see the actual code error along with other information such as a stacktrace to show how the code reached the path where the error happened.

Leaking too much info in user-facing error messages has historically been enough of a problem to get OWASP articles about it:

https://top10proactive.owasp.org/v3/en/c10-errors-exceptions

Well-run sites will have some kind of logging / exception-tracking behind the scenes that captures all the details about the error (stacktrace, request details, etc) for later review.

You know this one

https://en.wikipedia.org/wiki/Anna_Karenina_principle

?

There is one happy path in a bootloader and many many many more unhappy paths. Optimal UX on the unhappy path is orders of magnitude more expensive than the UX on the happy path. It's also true about error handling in general but a vague error message is a low priority issue compared to other ways your bootloader could be flawed.

For user errors, you should make the messages descriptive and actionable. For example "Please enter at least 5 quantities".

For system/app errors that is more of a crash, users shouldn't really need to know the details as they cannot do anything with it anyway. So a gentle "Something went wrong" is good.

Remember that most applications may show a generic error to the user but they log the exceptions/real errors in backend using tools like Sentry etc.

Keep it simple.

My assumption is that while the user may get this generic error, an error with actual detail goes to an internal team to actually look at what happened and fix it, with more detail.

I recently worked on an internal app at work, and the UI team didn't want us to provide technical details in the error messages from the backend, because they didn't think it was a good experience for a user to get too much technical jargon. They wanted the conversation to die there. I had to fight to create meaningful error messages that would go to a support team, while they still kept sending something akin to "something went wrong" to the users.

With Next.js parallel routes you can just error the partial with a default error.

Something like this https://shadcnpro.com/docs/components/default-error

Then the user has the chance to press "Try again".

First of all, the 500 error page is often included as part of the toolkit being used to make the site, as a generic response to most exceptions. The developer isn't generally going to explain every possible exception in detail to the end user; the most important thing is that they automatically get logs or error notifications with the ACTUAL exception, and can take action to fix it.

I appreciate the answers thus far. Still, it feels as if these errors are not useful for situations where there's virtually no existing accessible support for the end user for the product, i.e., Google, Facebook. In these cases, the developer may be able to look at the logs of that moment, but the likelihood that they'll even receive the complaint is next to nothing.

Often the error was caused by an intermittent problem, and trying again (an hour later; a day later) does indeed work.

As for developers, errors details may be separately logged elsewhere. So they don't need any specifics about the error from the user.

Finally if you show error details to the user in production, it may lead to leaking sensitive information (PII or system internals that may ease hacking).

Cloudflare historically included trace IDs which were helpful for troubleshooting for customer support/support engineers.

I have always assumed that developers had a message that contained actionable or meaningful info, but some frickin manager made them take it out.

Personally, they make my blood pressure skyrocket, it feels like the frickin manager or company (HP) is just taunting me - "I had a problem, loser, guess what it is!"

You don't want to expose details about your platform. Thousands (millions?) of sites have been compromised because errors caused them to dump public tracebacks.

> this message doesn't provide much actionable information

Even if it did, you'd likely not be able to do anything with that information (i.e., a web app returning an HTTP 500).

Details potentially leaks information the developer doesn't want out there. For example, in SharePoint Online you wouldn't want the correlation log provided to the end user -- it's not useful to the end user, it isn't necessarily limited to just what they did, and it may contain PII.

> unhelpful to the developers who presumably implemented that error messaging

In my example above, the user would relay to a technical support individual the date/time/, and the support individual could then correlate within the logs, potentially passing it back to the developer.

Now, if the developer did a poor job of correlating "friendly" error messages to something that can be diagnosed on the backend, that's on them.

    case UNEXPECTED_ERROR:
      return 'something went wrong'

Short yet true answer: because nobody cares. Not managers, not developers, not even users in most cases.

Sorry my friend, we, meticulous perfectionists, are marginalized minority

As a user: The recent Sonos app update shows what happens when you don't even bother with a generic error message. That app is so buggy that many failures don't trigger any sort of error at all, and the user is just left wondering what, if anything happened. Many buttons don't do anything at all (no animation, success, failure, page load, anything). Others load for a few seconds and then go back to the beginning with no message indicating what happened. Other boolean toggles just slide back to their previous state after a few seconds with no explanation. Having an error would've at least let you know "oh, the app is broken" rather than "I did something wrong".

---------------

As a dev at another small company supporting users: We have a lot of different failure modes that we try to handle, ranging from the specific (your auth is wrong, you're rate limited, your request is invalid, your request is too big, whatever) to the somewhat vague "there's been an error, please submit a help ticket with error ID #blahblahblah" where #blahblahblah actually corresponds to some backend logging that we can then further troubleshoot with them individually.

Then there's the "Something went wrong" errors, which are fallbacks of last resort... that one last safeguard in a cascading series of try/catches where we know the operation didn't succeed, but not in any failure mode we predicted. Maybe a server or function blew up halfway through an operation, but not in a way where we could've caught a stack dump or logged a request error. Maybe it's a type of crash we've never seen before, maybe a bug in some third-party lib, maybe a file parser died on an edge case in a user-generated file... whatever. We don't have any logging on that and we can't do any useful debugging on it, usually.

But you know what? It's still helpful for two reasons:

1) It lets the user know something unexpected happens. Sometimes trying again actually works. But even if it doesn't, it let them know that there was an unexpected error (and it's almost never their fault). If you don't even tell them that, well, like the terrible Sonos app, either they assume they did something wrong, or they think it succeeded when it really didn't.

2) These errors are for us (or at least should be) very far and few in between. If we get one report a month about one, we know, ok, there's some corner case bug in some dark corner that we've yet to catch. We can't really do anything about that, but we'll keep an eye out.

If, however, we suddenly start getting tens or hundreds of reports of these a day, we know something is very, VERY wrong on our infrastructure somewhere, maybe caused by a recent deploy. One customer reporting an undiagnosable bug isn't actionable, but a handful at the same time definitely is, and more than that would probably be an all-hands-on-deck emergency.

That's at our scale of a small business. At Facebook/Google scale, you can only hope they have more robust logging and super engineers, and even if that error doesn't help you as a individual user, maybe the 20th million occurrence of it this week will lead some obscure bug being fixed in some 20-year-old part of their code a few months from now, even if they don't tell you about it. That's the hope, anyway. Probably a lot of them just get completely ignored...