. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271 12.6. 将错误信息输出到标准错误而不是标准输出 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276 13 赖，并使依赖在 Rust 生态系统中保持一致。 • Rustfmt 格式化工具确保开发者遵循一致的代码风格。 • rust-analyzer 为集成开发环境（IDE）提供了强大的代码补全和内联错误信息功能。 通过使用 Rust 生态系统中丰富的工具，开发者在编写系统级代码时可以更加高效。 学生 Rust 适合学生群体，也适合有兴趣学习系统概念的人。许多人通过 Rust 学习了操作系统开发 阅读本书没有错误的方式：如果你想跳过前面的内容，尽管跳过！如果你遇到任何困惑，可能 需要回到前面的章节。请采取对你最有效的方式进行阅读。 学习 Rust 的一个重要部分是学会如何阅读编译器显示的错误信息：它们会指引你编写出能运 行的代码。为此，我们将提供许多不能编译的示例，以及在每种情况下编译器将显示的错误信 息。请知悉，如果你输入并运行一个随机示例，它可能无法编译！确保你阅读了示例周围的文 本

解决方案 3：使用乐观事务 乐观事务模型下，并不会有死锁问题，但应用端需要加上乐观事务在失败后的重试逻辑，具体重试逻辑见应 用端重试和错误处理。 4.9.4.1.4 解决方案 4：重试 正如错误信息中提示的那样，在应用代码中加入重试逻辑即可。具体重试逻辑见应用端重试和错误处理。 459 4.9.4.2 应用端重试和错误处理 尽管 TiDB 尽可能地与 MySQL 兼容，但其分布式系统的 如何判断当前集群存在写写冲突 可以通过 Grafana 监控查看集群写写冲突的情况： • 通过 TiDB 监控面板中 KV Errors 监控栏中 KV Backoff OPS 监控指标项，查看 TiKV 中返回错误信息的数量 图 94: kv-backoff-ops txnlock 表示集群中存在写写冲突，txnLockFast 表示集群中存在读写冲突。 • 通过 TiDB 监控面板中 KV Errors 高可以适度调大改参数，比如 1024。 10.2.6.1.2 从 log 定位 I/O 问题 • 如果客户端报 server is busy 错误，特别是 raftstore is busy 的错误信息，会和 I/O 有相关性。 可以通过查看监控：grafana -> TiKV -> errors 监控确认具体 busy 原因。其中，server is busy 是 TiKV 自身的 流控机制，TiKV

解决方案 3：使用乐观事务 乐观事务模型下，并不会有死锁问题，但应用端需要加上乐观事务在失败后的重试逻辑，具体重试逻辑见应 用端重试和错误处理。 4.9.4.1.4 解决方案 4：重试 正如错误信息中提示的那样，在应用代码中加入重试逻辑即可。具体重试逻辑见应用端重试和错误处理。 463 4.9.4.2 应用端重试和错误处理 尽管 TiDB 尽可能地与 MySQL 兼容，但其分布式系统的 TiCDC 绑定的 IP 地址和端口。 7.6.9.1 API 统一错误格式 对 API 发起请求后，如发生错误，返回错误信息的格式如下所示： { "error_msg": "", "error_code": "" } 如上所示，error_msg 描述错误信息，error_code 则是对应的错误码。 885 7.6.9.2 API List 接口统一返回格式 一个 API curl -X GET http://127.0.0.1:8300/api/v2/health 如果集群健康，则返回 200 OK 和一个空的 json {}： {} 如果集群不健康，则返回错误信息。 7.6.9.5 创建同步任务 该接口用于向 TiCDC 提交一个同步任务，请求成功会返回 200 OK。该返回结果表示服务器收到了执行命令指 示，并不代表命令被成功执行。 7.6.9.5

解决方案 3：使用乐观事务 乐观事务模型下，并不会有死锁问题，但应用端需要加上乐观事务在失败后的重试逻辑，具体重试逻辑见应 用端重试和错误处理。 4.8.4.1.4 解决方案 4：重试 正如错误信息中提示的那样，在应用代码中加入重试逻辑即可。具体重试逻辑见应用端重试和错误处理。 392 4.8.4.2 应用端重试和错误处理 尽管 TiDB 尽可能地与 MySQL 兼容，但其分布式系统的 如何判断当前集群存在写写冲突 可以通过 Grafana 监控查看集群写写冲突的情况： • 通过 TiDB 监控面板中 KV Errors 监控栏中 KV Backoff OPS 监控指标项，查看 TiKV 中返回错误信息的数量 图 93: kv-backoff-ops txnlock 表示集群中存在写写冲突，txnLockFast 表示集群中存在读写冲突。 • 通过 TiDB 监控面板中 KV Errors 高可以适度调大改参数，比如 1024。 10.2.6.1.2 从 log 定位 I/O 问题 • 如果客户端报 server is busy 错误，特别是 raftstore is busy 的错误信息，会和 I/O 有相关性。 可以通过查看监控：grafana -> TiKV -> errors 监控确认具体 busy 原因。其中，server is busy 是 TiKV 自身的 流控机制，TiKV

从如上代码可总结出身份验证的步骤： 1、收集用户身份/凭证，即如用户名/密码； 2、调用 Subject.login 进行登录，如果失败将得到相应的 AuthenticationException 异常，根 据异常提示用户错误信息；否则登录成功； 3、最后调用 Subject.logout 进行退出操作。 如上测试的几个问题： 1、用户名/密码硬编码在 ini 配置文件，以后需要改成如数据库存储，且密码需要加密存储； 验证对话框输入“zhang/123” 即可登录成功进行访问。 3、基于表单的拦截器身份验证 基于表单的拦截器身份验证和【1】类似，但是更简单，因为其已经实现了大部分登录逻辑； 我们只需要指定：登录地址/登录失败后错误信息存哪/成功的地址即可。 3.1、shiro-formfilterlogin.ini [main] authcBasic.applicationName=please login LoginController 用于显示登录表单页面，其中 shiro authc 拦截器进行登录，登录失败的话 会把错误存到 shiroLoginFailure 属性中，在该控制器中获取后来显示相应的错误信息。 在控制器方法上使用@RequiresPermissions 指定需要的权限信息，其他的都是类似的，请参 考源码。 Web 层标签库 com.github

的时间 TiClient Region Error OPS：TiKV 返回 Region 相关错误信息的数量 Lock Resolve OPS：事务冲突相关的数量 Load Schema Duration：TiDB 从 TiKV 获取 Schema 的时间 KV Backoff OPS：TiKV 返回错误信息的数量（事务冲突等） TiKV leader：各个 TiKV 节点上 Leader 的数量分布 慢请求日志格式，区分处理时间长与排队时间长的任务 MySQL 协议握手阶段发生错误不打印日志，避免 KeepAlive 造成大量日志 优化 Out of range value for column 的错误信息 修复 Update 语句中遇到子查询导致结果错误的问题 调整 TiDB 进程处理 SIGTERM 的行为，不等待正在执行的 Query 完成 添加 Scatter Range 调度，调度指定 Raw KV 支持 Batch Put、Batch Get、Batch Delete 和 Batch Scan 解决太多 snapshot 导致的 OOM 问题 Coprocessor 返回更详细的错误信息 支持通过 tikv-ctl 动态修改 TiKV 的 block-cache-size 进一步完善 importer 功能 简化 ImportSST::Upload 接口 设置 gRPC

表示，或者当没有参数时返回空字符串。 args 传给异常构造器的参数元组。某些内置异常 (例如OSError) 接受特定数量的参数并赋予此元 组中的元素特殊的含义，而其他异常通常只接受一个给出错误信息的单独字符串。 with_traceback(tb) 此方法将 tb 设为异常的新回溯信息并返回该异常对象。它通常以如下的形式在异常处理程序 中使用: try: ... except SomeException: 可以引发一个异常，这样就能打 印出栈回溯信息，以便找出导致问题的失控程序。 exception NameError 当某个局部或全局名称未找到时将被引发。此异常仅用于非限定名称。关联的值是一条错误信息， 其中包含未找到的名称。 exception NotImplementedError 此异常派生自RuntimeError。在用户自定义的基类中，抽象方法应当在其要求所派生类重写该 方法，或 属性会根据 Windows 错误码 来确定，而 errno 参数会被忽略。在其他平台上，winerror 参数会被忽略，并且winerror 属 性将不存在。 strerror 操作系统所提供的相应错误信息。它在 POSIX 平台中由 C 函数 perror() 来格式化，在 Windows 中则是由 FormatMessage()。 filename filename2 对于与文件系统路径有关

表示，或者当没有参数时返回空字符串。 args 传给异常构造器的参数元组。某些内置异常 (例如OSError) 接受特定数量的参数并赋予此元 组中的元素特殊的含义，而其他异常通常只接受一个给出错误信息的单独字符串。 with_traceback(tb) 此方法将 tb 设为异常的新回溯信息并返回该异常对象。它通常以如下的形式在异常处理程序 中使用: try: ... except SomeException: 可以引发一个异常，这样就能打 印出栈回溯信息，以便找出导致问题的失控程序。 exception NameError 当某个局部或全局名称未找到时将被引发。此异常仅用于非限定名称。关联的值是一条错误信息， 其中包含未找到的名称。 exception NotImplementedError 此异常派生自RuntimeError。在用户自定义的基类中，抽象方法应当在其要求所派生类重写该 方法，或 属性会根据 Windows 错误码 来确定，而 errno 参数会被忽略。在其他平台上，winerror 参数会被忽略，并且winerror 属 性将不存在。 strerror 操作系统所提供的相应错误信息。它在 POSIX 平台中由 C 函数 perror() 来格式化，在 Windows 中则是由 FormatMessage()。 filename filename2 对于与文件系统路径有关

表示，或者当没有参数时返回空字符串。 args 传给异常构造器的参数元组。某些内置异常 (例如OSError) 接受特定数量的参数并赋予此元组中 的元素特殊的含义，而其他异常通常只接受一个给出错误信息的单独字符串。 with_traceback(tb) 此方法将 tb 设为异常的新回溯信息并返回该异常对象。它通常以如下的形式在异常处理程序中使 用: try: ... except SomeException: 可以引发一个异常，这样就能打印出栈回溯信 息，以便找出导致问题的失控程序。 exception NameError 当某个局部或全局名称未找到时将被引发。此异常仅用于非限定名称。关联的值是一条错误信息，其 中包含未找到的名称。 exception NotImplementedError 此异常派生自RuntimeError。在用户自定义的基类中，抽象方法应当在其要求所派生类重写该方法， 或 属性会根据 Windows 错误码来确 定，而 errno 参数会被忽略。在其他平台上，winerror 参数会被忽略，并且winerror 属性将不存 在。 strerror 操作系统所提供的相应错误信息。它在 POSIX 平台中由 C 函数 perror() 来格式化，在 Windows 中则是由 FormatMessage()。 filename filename2 对于与文件系统路径有关

表示，或者当没有参数时返回空字符串。 args 传给异常构造器的参数元组。某些内置异常 (例如OSError) 接受特定数量的参数并赋予此元组中 的元素特殊的含义，而其他异常通常只接受一个给出错误信息的单独字符串。 with_traceback(tb) 此方法将 tb 设为异常的新回溯信息并返回该异常对象。它通常以如下的形式在异常处理程序中使 用: try: ... except SomeException: The Python Library Reference, 发布 3.9.20 exception NameError 当某个局部或全局名称未找到时将被引发。此异常仅用于非限定名称。关联的值是一条错误信息，其 中包含未找到的名称。 exception NotImplementedError 此异常派生自RuntimeError。在用户自定义的基类中，抽象方法应当在其要求所派生类重写该方法， 或 属性会根据 Windows 错误码来确 定，而 errno 参数会被忽略。在其他平台上，winerror 参数会被忽略，并且winerror 属性将不存 在。 strerror 操作系统所提供的相应错误信息。它在 POSIX 平台中由 C 函数 perror() 来格式化，在 Windows 中则是由 FormatMessage()。 filename filename2 对于与文件系统路径有关