速度停电可以教导我们写入错误消息

2021-06-09 20:53:52

如果您错过了它,在6月8日,2021年6月8日速度,速度迅速' C CDN的停电,占据了一些互联网'最大的网站(包括BBC,英国政府,Reddit,以及纽约时报 - Amazon.com也有其CSS无法加载)。

如果您恰好在速度访问这些网站和中断时,您看到了下面的相对无与伦比的错误消息:

作为前端开发人员,我的眼睛扫描错误的错误,如这些数字 - 在这种情况下," 503" - 表明错误是' t我的错,我可以继续我的生活。

遗憾的是,大多数互联网用户都在读取HTTP状态码的艺术中训练,所以这个错误消息是对他们特别有用的。特别是当错误消息的固体部分时是一个笑话。

大多数互联网用户aren' t开发人员,所以只需编写错误代码和它的名称(503服务不可用)只是不够好。

Norman Nielsen Group(1998年回来!)为我们提供了一些基本指导原则,用于编写更好的错误消息:

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

你想要做的最后一件事是让你的用户感到愚蠢,或者他们'对服务问题的故障。导致错误的沟通有助于清除任何混淆。

明确关注"我们"当错误引起的问题时(通常在5xx范围内的HTTP状态代码)引起的。

对于由用户引起的错误(通常在4xx范围内的HTTP状态代码),也会显式。例如,可以传达403个禁止错误(您知道用户ISN' t授权查看内容的T):

虽然用户可能不是技术,但他们仍然需要解释为什么他们会看到你的错误屏幕。

拍摄经典的404错误消息:" 404未找到404"您可以为单词的非技术用户明显更好:

添加A"为什么",使它更好,给他们解决问题的方法:

它'在您的中断细节中更新错误消息,以及当您预计服务再次可用时,它相对困难。

更好的方法是链接到您的状态页面,或Twitter帐户,或两者,如Github' s case:

在404的情况下,您可能希望列出用户可以采取的一些步骤来解决问题,例如:

而在5xx服务器错误的情况下,您希望与用户进行通信,他们可以做任何事情,并且它'不是他们的错。

他们设定了期望,在网站正在经历停机时,他们可能会缓慢回应

我们作为开发人员应该将速度停电作为改善错误消息的机会。你永远不知道当你的诙谐笑话可能最终被数亿互联网用户最终看到,所以试着有助于帮助,并解释:

当然,如果你'像速度一样运行CDN,你' LL可能仍然需要在错误消息中需要请求ID和其他诊断,以帮助您的支持人员调试问题。人类可读的错误消息不得不牺牲删除所有技术信息。

使用我们的免费层次,通过电子邮件和松弛监控10个URL和通知。