Skip to content

Latest commit

 

History

History
50 lines (32 loc) · 1.86 KB

BUG_REPORT.md

File metadata and controls

50 lines (32 loc) · 1.86 KB
Raw

Bug Report

你在使用的过程中可能会遇到如下的错误：

服务器错误

新版 PKU Helper 服务器引入了全局错误码 (global error code) 和错误请求编号 (bad request ID) 的机制。在 PKU Helper 4 iOS 客户端中，一个标准的后端错误弹窗格式为 [xxxx] xxxxxxx (rid: xxx) 也就是 [${errcode}] ${message} (rid: ${rid})

全局错误码 Global Error Code

只可能有如下的取值:

  • 4-5 位正数： 表示一个定义好的具体错误
  • 一位负数： 表示一个错误范围，但是具体错误不明

错误请求编号 Bad Request ID

只可能有如下的取值：

  • 等于 -1： 这表示当次请求没有必要记录
  • 正数： 表示当次错误请求的细节已经被记录，可以根据 rid 的值查询到当次错误请求的信息。

客户端错误

所有不遵循服务器错误消息格式的错误弹窗均意味着一个客户端错误。最主要的错误消息来源于 Alamofire 和 ObjectMapper ，通常是网络错误。

客户端崩溃

App 卡死或者突然闪退重启。

反馈哪些信息

请务必/尽可能提供如下的信息：

  • App 版本号和构建号（可以在首页右上角的 Setting 项中查到）
  • iOS 系统版本（例如 iOS 12.4）
  • 手机型号（例如 iPhone 6s)
  • 对于以弹窗形式呈现的服务器错误/客户端错误，请提供消息正文或截图
  • 对于服务器错误，请务必提供全局错误码和错误请求编号（如果它不为 -1）。
  • 对于客户端崩溃，请尝试复现崩溃，如果无法复现，请尝试回忆崩溃是如何引发的，尽可能向我们提供崩溃的复现方法。

反馈渠道

你可以通过 App 中的 Feedback/Contact Us 将错误反馈给我们（等价地也可以 联系我们）。