13、实用错误信息与敏捷协作的关键要点

实用错误信息与敏捷协作的关键要点

1. 提供有用的错误信息

在应用程序的实际部署和使用中，错误时有发生。无论是计算模块故障，还是与数据库服务器的连接中断，当无法满足用户请求时，需要优雅地处理这些情况。

1.1 错误信息的现状与问题

仅仅弹出一个优雅的道歉消息给用户是不够的。像“出问题了”这样的通用消息，虽然比应用程序崩溃消失要好，但无法帮助团队诊断问题。用户在向支持团队报告问题时，由于缺乏详细信息，难以提供足够的帮助。

1.2 日志记录的作用与不足

日志记录是常见的解决方案，应用程序在出错时记录错误细节，可保存为文本文件或发布到系统事件日志。然而，日志记录对开发者有帮助，但对用户而言，像图7.2那样的异常消息往往让他们一头雾水，不知道自己哪里做错，也不知道如何解决或向技术支持报告什么。

1.3 提供详细错误信息的重要性

以登录界面调用应用程序中间层，中间层向数据库层请求，数据库层因无法连接数据库抛出异常为例。中间层将异常包装后向上传递，UI层应至少告知用户这是系统错误，与用户输入无关。当用户反馈无法登录时，仅靠可能有数百条记录的日志文件，很难找到相关细节。因此，在给用户的消息中提供更多细节至关重要。

1.4 平衡用户与开发者需求

一方面，要为用户提供清晰、高层次的错误解释，让他们理解问题并尝试解决；另一方面，要提供底层的详细错误信息，以便开发者定位代码中的实际问题。可以通过在错误消息中包含超链接的方式来平衡这两个目标。开发阶段可默认显示详细信息，生产阶段则提供链接或引用到错误日志，支持团队可让用户点击链接读取引用信息，快速找到日志中的具体细节。对