Golang在工程实践中的错误处理 彭友顺 石墨文档 产研负责人 目 录 为什么我们处理错误会这么慢 01 如何完善错误信息 02 优雅处理错误信息 03 分布式错误处理 04 错误信息手册的必要性 05 为什么我们处理错误 会这么慢 第一部分 错误信息不够完善 why 原因 出现 错误 定位 慢 恢复 慢 效率低 为什么我们处理错误会这么慢 错误处理不够优雅 分布式错误难以串联 优雅处理错误信息 第三部分 为什么定位慢？-- 错误处理 不要透传错误 错误码唯一性 记录一次错误 假设用户反馈了无法打开一个文件 我们的程序员非常认真 记录了文件不存在的错误日志 • 同样的错误信息，非常多的杂音 • 每个Error，都去查看一次对应代码，排查效率低 • 占用存储空间 • 最外层入口处只记录一次错误日志 为什么定位慢？-- 错误处理 带来新的问题，无法定位整个代码执行链路 日志分析不出是哪个service 调用了MySQL 为什么定位慢？-- 错误处理 带来新的问题，无法定位整个代码执行链路 不要透传错误 错误码唯一性 记录一次错误 • 不能透传错误，fmt.Errorf • 如果不考虑性能 • 日志开启Stack • 错误追加Stack 为什么定位慢？-- 错误处理 不要透传错误 错误码唯一性 记录一次错误 文件不存在 数据表里不存在

国际化和本地化 10.1 设置默认地区 10.2 本地化资源 10.3 国际化站点 4 10.4 小结 11.错误处理，调试和测试 11.1 错误处理 11.2 使用GDB调试 11.3 Go怎么写测试用例 11.4 小结 12.部署与维护 12.1 应用日志 12.2 网站错误处理 12.3 应用部署 12.4 备份和恢复 12.5 小结 13.如何设计一个Web框架 13.1 项目规划 者那些缺失的地方，请一起参与到这个开 源项目中来，让我们的这个库争取成为Go的标准库。 links links 目录 上一节: 国际化站点 下一节: 错误处理，故障排除和测试 225 11 错误处理，调试和测试 11 错误处理，调试和测试 我们经常会看到很多程序员大部分的"编程"时间都花费在检查bug和修复bug上。无论你是在编写修改代码还是重构系 统，几乎都是花费大量的时间在进 但是遗憾的是很多程序员不愿意在错误处理、调试和测试能力上下工夫，导致后面应用上线之后查找错误、定位问题 花费更多的时间。所以我们在设计应用之前就做好错误处理规划、测试用例等，那么将来修改代码、升级系统都将变 得简单。 开发Web应用过程中，错误自然难免，那么如何更好的找到错误原因，解决问题呢？11.1小节将介绍Go语言中如何处 理错误，如何设计自己的包、函数的错误处理，11.2小节将介绍如何使用

goroutine channels Buffered Channels Range和Close Select 超时 runtime goroutine 错误处理 Error类型 自定义Error 错误处理 总结 更多Golang资源包：https://github.com/0voice/Introduction-to-Golang 关键字 Go语言设计的关键字，了解这些关键字有助于命名变量的冲突避免 返回正在执行和排队的任务总数 GOMAXPROCS : 用来设置可以并行计算的CPU核数的最大值，并返回之前的值。 错误处理 Go语言主要的设计准则是：简洁、明白，简洁是指语法和C类似，相当的简单，明白是指任何语句都是 很明显的，不含有任何隐含的东西，在错误处理方案的设计中也贯彻了这一思想。 在C语言里面是通过返回 -1 或者 NULL 之类的信息来表示错误，但是对于使用者来说，不查看相应的API os.Open 打开一个文件，如果出现错误，那么就会调用 log.Fatal 来输出错误信 息： 类似于 os.Open 函数，标准包中所有可能出错的API都会返回一个 error 变量，以方便错误处理，这个 小节将详细地介绍 error 类型的设计，和讨论开发Web应用中如何更好地处理 error 。 Error类型 error类型是一个接口类型，这是它的定义： error是一个内置的接口类型，可以在

数据 12.10 XML 数据格式 12.11 用 Gob 传输数据 12.12 Go 中的密码学 第13章：错误处理与测试 13.1 错误处理 13.2 运行时异常和 panic 13.3 从 panic 中恢复（Recover） 13.4 自定义包中的错误处理和 panicking 13.5 一种用闭包处理错误的模式 13.6 启动外部命令和程序 13.7 Go 中的单元测试和基准测试 16.5 不需要将一个指向切片的指针传递给函数 16.6 使用指针指向接口类型 16.7 使用值类型时误用指针 16.8 误用协程和通道 16.9 闭包和协程的使用 16.10 糟糕的错误处理 第 17章 模式 17.1 关于逗号ok模式 第 18章 出于性能考虑的实用代码片段 18.1 字符串 18.2 数组和切片 18.3 映射 18.4 结构体 18.5 接口 18 语言的函数式和面 向对象编程进行透彻的讲解，包括如何使用 Go 语言来构造大型项目（第 9 章）。 在本书的第三部分，你将会学习到如何处理不同格式的文件（第 12 章）和如何在 Go 语言中巧妙地使用错误处理机 制（第 13 章）。然后我们会对 Go 语言中最值得称赞的设计 goroutine 和 channel 进行并发和多核应用的基 本技巧的讲解（第 14 章）。最后，我们会讨论如何将 Go 语言应用到分布式和

接着使用 app.errorhandler() 装饰器注册一个错误处理函数，它的作用和视图 函数类似，当 404 错误发生时，这个函数会被触发，返回值会作为响应主体返回给 客户端： app.py：404 错误处理函数 第 6 章：模板优化 48 @app.errorhandler(404) # 传入要处理的错误代码 def 需要返回字典，等同于return {'user': u ser} 这个函数返回的变量（以字典键值对的形式）将会统一注入到每一个模板的上下文 环境中，因此可以直接在模板中使用。 现在我们可以删除 404 错误处理函数和主页视图函数中的 user 变量定义，并删 除在 render_template() 函数里传入的关键字参数： @app.context_processor def inject_user(): 本章介绍的自定义错误页面是为了引出两个重要的知识点，因此并没有着重介 绍错误页面本身。这里只为 404 错误编写了自定义错误页面，对于另外两个常 见的错误 400 错误和 500 错误，你可以自己试着为它们编写错误处理函数和 对应的模板。 因为示例程序的语言和电影标题使用了英文，所以电影网站的搜索链接使用了 IMDb，对于中文，你可以使用豆瓣电影或时光网。以豆瓣电影为例，它的搜索 链接为 https://movie

. . . . . . . . . . . . . . . . . . . . . . . . . . 159 VIII 第四天：下午 162 28 Welcome Back 163 29 错误处理 164 29.1 Panics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 . . . . . . . . . . . . . . . . . . . 214 37.2.7 Rust 错误处理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214 37.2.8 C++ 错误处理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45.1 绑定示例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 45.2 CXX 错误处理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 45.2.1 CXX Error Handling:

并发原语的原理与应用模式 • 低级同步原语 (sync 和 atomic) 并发：优先考虑并发设计 Part7 – 错误处理 践行哲学，遵循惯例，认清本质，理解原理 • 错误处理的几种策略 • 优化 if err != nil • Panic 不是错误处理 错误处理：保守与创新 Part8 – 编程实践：测试、调试与性能剖析 践行哲学，遵循惯例，认清本质，理解原理 • Go 测试惯例与组织形式

config */ export default { //key: value }; src/common/controller 控制器，放一些通用的控制器。其中 error.js 里错误处理的不同行为，项目里可以根据需要进 行修改。 src/common/runtime 项目运行时生成的一些目录，如：缓存文件目录，用户上传的文件临时存放的目录。 src/home home staff 204 Sep 8 19:14 home/ common 模块 common 模块是个通用模块，该模块下存放一些通用的功能，如： 通用的配置，runtime 目录， 启动文件，错误处理控制器等。 注 ：该模块下的控制器不能响应用户的请求。 默认模块 默认模块为 home 模块。当解析用户的请求找不到模块时会自动对应到 home 下。 可以通过配置 default_module * @return {Promise} [] */ __call(){ ... } } 错误处理 当 url 不存在或者当前用户没权限等一些异常请求时，这时候会调用错误处理。 ThinkJS 内置了一 套详细的错误处理机制，具体请见 扩展功能 -> 错误处理。 数据校验 控制器里在使用用户提交的数据之前，需要对数据合法性进行校验。为了降低控制器里的逻辑复 杂度，ThinkJS

模块获取受支持的编码格式列表。 errors 是一个可选的字符串参数，用于指定如何处理编码和解码错误 - 这不能在二进制模式下使用。 可以使用各种标准错误处理程序（列在错误处理方案 ），但是使用codecs.register_error() 注册的任何错误处理名称也是有效的。标准名称包括: • 如果存在编码错误，'strict' 会引发ValueError 异常。默认值 None 具有相同的效果。 • ）插入有错误数据的地方。 • 'surrogateescape' 将把任何不正确的字节表示为 U+DC80 至 U+DCFF 范围内的下方替 代码位。当在写入数据时使用 surrogateescape 错误处理器时这些替代码位会被转回到相 同的字节。这适用于处理具有未知编码格式的文件。 • 'xmlcharrefreplace' 仅在写入文件时才受到支持。编码格式不支持的字符将被替换为相 应的 XML 如果系统调用被中断，但信号处理程序没有触发异常，此函数现在会重试系统调用，而不是 触发InterruptedError 异常 (原因详见 PEP 475)。 • 增加了 'namereplace' 错误处理接口。 在 3.6 版本发生变更: • 增加对实现了os.PathLike 对象的支持。 • 在 Windows 上，打开一个控制台缓冲区将返回io.RawIOBase 的子类，而不是io.FileIO。

模块获取受支持的编码格式列表。 errors 是一个可选的字符串参数，用于指定如何处理编码和解码错误 - 这不能在二进制模式下使用。 可以使用各种标准错误处理程序（列在错误处理方案 ），但是使用codecs.register_error() 注 册的任何错误处理名称也是有效的。标准名称包括: • 如果存在编码错误，'strict' 会引发ValueError 异常。默认值 None 具有相同的效果。 ）插入有错误数据的地方。 • 'surrogateescape' 将把任何不正确的字节表示为 U+DC80 至 U+DCFF 范围内的下方替代 码位。当在写入数据时使用 surrogateescape 错误处理器时这些替代码位会被转回到相同的 字节。这适用于处理具有未知编码格式的文件。 • 'xmlcharrefreplace' 仅在写入文件时才受到支持。编码格式不支持的字符将被替换为相应 的 XML 如果系统调用被中断，但信号处理程序没有触发异常，此函数现在会重试系统调用，而不是 触发InterruptedError 异常 (原因详见 PEP 475)。 • 增加了 'namereplace' 错误处理接口。 在 3.6 版本发生变更: • 增加对实现了os.PathLike 对象的支持。 • 在 Windows 上，打开一个控制台缓冲区将返回io.RawIOBase 的子类，而不是io.FileIO。