专栏首页跨界架构师如何优雅做系统错误提示?

如何优雅做系统错误提示?

大家好,我是Z哥。​

不管是日常的工作中还是生活中,我们每天会用到很多软件系统。

不知道你有没有过这样的感受,当你使用软件遇到异常的时候,有时候软件给出的错误提示让人摸不着头脑。唯一的办法就是复制到搜索引擎搜一下,看看有没有哪个不幸的人与我遇到一样的问题。

所以,一个好的错误提示特别重要。它不但能让使用者明白当前到底发生了什么,甚至还能引导如何解决异常。达到这个程度的话自然可以大大提高系统的使用效率,也能间接降低己方商务人员或者产品经理的培训成本。

因此,作为程序员群体的一份子,在这里我想呼吁大家认真对待错误提示,特别是那些不是给“人”看的错误提示……

作为软件的创造者,我们虽然无法避免出现异常、出现bug,但是我们可以做到避免无意义的错误提示产生。

首先,一些常见的容易让人摸不着头脑的错误提示要先避免。比如,

  • 提交失败。
  • 数据读取失败。
  • ……

这类错误提示看上去准确表达了当前遇到的问题,实际上啥也没说。你想象一下,当我点击一个提交按钮之后,页面没有跳转而且还弹个框出来,哪怕里面什么字都没写,我能也猜到这里估计出错了。

但是具体错在哪?作为用户该如何处理?一概不知。

另外,还有一种常见的情况是,错误提示含有太多的技术术语,使用者根本不明白啥意思,也不关心这些。比如,

  • 远程服务响应超时。
  • 事务执行失败,XX保存失败。
  • ……

其实这还算好的,有的甚至把技术框架中返回的expcetion信息直接作为错误提示出来。这对用户看起来就是一堆乱码,他只会找你说“系统乱码了,帮我解决一下……”。

如果上面的景象就在你日常工作中发生,也不用不好意思,我们都是这么过来的。Z哥我自己以前也同样没意识到这个问题,经过了这些年的工作之后,我认为,编写正确的错误提示可以按照以下的思路来。

/01 不要提示用户不关心的信息/

首先来个排除法。

我们作为程序员经常需要通过一些技术性的线索来排查问题,特别是expcetion信息。但用户并不关心它们,而且他们无法对此类消息进行任何处理。

所以,这些信息记录到日志里就好,页面上无需给出这种用户不关心的信息。

/02 清楚表达问题原因/

让用户清楚的知道问题的原因,是他能否自行解决问题的基础。

比如,前面提到的“提单失败”的例子,你告诉他由于缺少XX信息导致提交失败,那么使用者自然会去想办法把缺少的信息给补上。

我还记得我之前用某个邮箱的时候,有封邮件发不出去,它总是提示我“邮件发送失败。”我真是服了,到底啥原因发送失败,后来经过自己不断的测试才知道是某个附件太大了导致发送失败。

/03 给出引导建议/

这点在一些企业内部使用的系统,以及一些toB的项目中特别重要。因为大多数系统使用者都只负责自己工作相关的部分,对其他的模块并不了解。所以,哪怕你将问题的原因表达的很清楚,但是他还是不知道该如何解决,只能寻求产品经理或者开发人员的协助。

比如,电商平台的客服在后台替用户修改订单收货地址的时候,发现某个地区下没有可用快递可选。如果你没有给出引导,诸如“联系XX人员进行设置。”之类的内容,那么他们只能来找你解决,无其他路可走。

如果想做得更好一些,针对某些场景可以直接放出下一步操作的连接,这样用户可以直接到达需要他进行操作的页面。

/04 提示内容尽可能简短/

文字一多,大多数人都不会逐字逐句看的,甚至有些人会完全不看。

Z哥工作中遇到过无数次这种情况。不管是错误提示还是操作提示,不管你写的多么详细、清楚,只要文字超过2行或者有几十个字以上,很多人看都不看直接截个图发给你,问你该怎么办?

听说有个美国机构做过相关的研究:

如果句子中的单词数不超过8个,读者可以理解其中的100%。如果句子包含43个单词或更长的单词,则读者的理解力将下降到不足10%。

虽然这个研究说的是英文,但是中文也是类似的道理。不过我没找到这个研究的具体出处,不知道真假,但是我觉得这个结论还是很符合常识的。

以上这4点说起来简单,也很好理解,没什么新奇的。但是真正做的时候很多人就把它们抛之脑后了。

当然,比给出合理的错误提示更好的是,避免出现错误。所以你还可以更进一步,提前规避掉一些错误。

比如,

  • 为了避免日期选择超过有效范围,可以对有效范围外的日期设置为禁用状态。
  • 为了避免在信用卡卡号之类的文本框内输入数字以外的字符,做一下输入限制。
  • 为了避免在弱网络下页面无法正常加载而提示错误,可以做缓存,提前预存一些数据在本地。
  • ……

好了,总结一下。

这篇呢Z哥和你分享了我对软件系统抛出的错误提示的看法。我认为好的错误提示需要符合以下4点。

  1. 不要提示用户不关心的信息
  2. 清楚表达问题原因
  3. 给出引导建议
  4. 提示内容尽可能简短

如果可以的话,还可以通过做一些前置的限制约束来提前规避掉一些可能发生的异常。

希望对你有所帮助。

作者:Zachary

出处:https://zacharyfan.com/archives/1250.html

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • 就简单聊聊沟通效率问题

      沟通效率是指依据利益点,选择适当的时间、方式、手段,快捷、准确、及时传递信息产生的实效性和节奏感。有效度是指沟通对信息接受者影响的效果与程度。

    Zachary_ZF
  • 做「容量预估」可没有true和false

    虽然如此,但是那些体量达到亿级或者是千万级的产品也只是少数公司的专属。对于整个行业里百万+的程序员群体来说,估计也就只有10%人有机会接触到这些“大系统”。

    Zachary_ZF
  • 如何一步一步用DDD设计一个电商网站(四)—— 把商品卖给用户

    上篇中我们讲述了“把商品卖给用户”中的商品和用户的初步设计。现在把剩余的“卖”这个动作给做了。这里提醒一下,正常情况下,我们的每一步业务设计都需要和领域专家进...

    Zachary_ZF
  • SecureCRT使用sftp上传较大文件意外暂停

    今天在一台跳转机使用SecureCRT的sftp上传较大文件时,发现中途会时常停止传输,给出提示如下:

    Alfred Zhao
  • SpringBoot系列-- Mybatis配合AOP和注解实现动态数据源切换配置

    随着应用用户数量的增加,相应的并发请求的数量也会跟着不断增加,慢慢地,单个数据库已经没有办法满足我们频繁的数据库操作请求了。

    田维常
  • ZOJ 3620 Escape Time II

    题意:      从初始房间到达终止房间需要经过一系列的房间,没经过一个房间会得到一个价值,从一个房间到达另一个房间同时需要消耗一定的时间,在规定的时间内从初始...

    用户1624346
  • 每天一道剑指offer-孩子们的游戏(圆圈中最后剩下的数)

    Java实现的话,可以使用LinkedList,考虑删除节点的效率。模拟游戏过程即可:其实这是个约瑟夫环问题,但是绝对没必要去死记硬背数学公式,直接用链表模拟游...

    乔戈里
  • 给一台腾讯云服务器配上多个免费外网弹性IP

    https://cloud.tencent.com/document/product/213/15379#.E7.BD.91.E5.8D.A1.E7.9B.B8...

    Cong Min
  • 浅析流量洪峰下的云开发高可用架构设计

    艳杰,腾讯高级前端开发工程师,云开发团队核心开发专注于中后台系统开发以及系统架构设计。

    腾讯云开发TCB
  • mongoDB 3.0+ 查询性能分析

    为了演示的效果,我们先来创建一个有200万个文档的记录。(我自己的电脑耗了15分钟左右插入完成。如果你想插更多的文档也没问题,只要有耐心等就可以...

    MongoDB中文社区

扫码关注云+社区

领取腾讯云代金券