Fastly大面积中断教会我们如何编写错误信息 - onlineornot


在 2021 年 6 月 8 日大约 15 分钟的时间里,Fastly 的 CDN 出现中断,导致一些互联网最大的网站 CSS 无法加载(包括 BBC、英国政府、Reddit 和纽约时报 - Amazon.com 也出现故障)。
作为前端开发人员,我的眼睛会扫描这些错误消息中的数字——在这种情况下,是“503”——表明错误不是我的错,我可以继续我的生活。
如果您在 Fastly 中断期间碰巧访问了这些网站,您会看到以下相对无用的错误消息 503:

不幸的是,大多数互联网用户没有接受过阅读HTTP 状态代码的训练,所以这个错误信息对他们来说并不是特别有用。特别是当错误消息的一部分是开玩笑的时候。
 
我们可以写出更好的错误信息
大多数互联网用户不是开发人员,因此仅编写错误代码及其名称(503 Service Unavailable)是不够的。
诺曼尼尔森集团(!早在1998年),为我们提供了更好的写入错误消息的一些基本的指导原则:

  • 用简单的英语(或您支持的任何语言)书写
  • 告诉用户到底出了什么问题
  • 告诉用户如何解决问题

更具体地说,我们可以通过回答以下四个问题来编写更好的错误消息:
  1. 谁造成了错误?
  2. 发生了什么,为什么?
  3. 什么时候会修好?
  4. 用户如何响应错误?

如果您的错误信息涵盖了这四点,那么您可以考虑添加幽默和一些品牌标识。