错误处理
我们的错误处理使用了自定义错误码的方式
成功一律呈现 200,错误一律 500,已知的错误代码全部返回 233,交由前端处理
有一点除外,就是刷新 token
的接口,如果出现了 token 失效,将会返回 205
如果成功刷新 token 将会返回正常的响应,未成功则为 401
原因是我们实现了无感刷新 token,但是由于原生 fetch
没有拦截器,我们不得不采用这种方式实现无感刷新
如果有更好的建议,欢迎联系我们
自定义错误码命名规范
可以查看后端项目的 src/error/kunErrorList.ts
文件
markdown
/**
* @number {1....}
* @number {.1...}
* @number {..1..} - 1 -> userService
* @number {...1.}
* @number {....1} - 某个 service 错误的序号,从上到下
*/
错误码参考
可以在前端项目的 src/error/errorI18n.ts
文件中查看
需要注意的是,这里的 (-B) 表示 -backend
,表明这是一个后端的错误,这是为了和前端的错误进行区分
markdown
// User Part
10101: `User not found (-B)`,
10102: `User password error (-B)`,
10103: `Email verification code error (-B)`,
10104: `Email is already registered, please change it (-B)`,
10105: `Username is already registered, please change it (-B)`,
10106: `User bio is too long (-B)`,
10107: `Invalid Email, Name, Password, or Verification Code Format (-B)`,
10108: `Invalid password format (-B)`,
10109: `Invalid Email or Verification Code Format (-B)`,
10110: `Avatar image upload error. The image is an array. (-B)`,
10111: `Avatar image upload error. The final compressed size of the image exceeds 50KB. (-B)`,
10112: `In cooldown for login, two identical login attempts should have a one-minute interval. (-B)`,
// Topic Part
10201: `Your daily topic limit has been reached for today. (-B)`,
10202: `Your moemoepoints are less than 1100, so you can't use the topic suggestion feature (-B)`,
10204: `Topic title length exceed 40 characters. Or empty. (-B)`,
10205: `Topic content length exceed 100007 characters. Or empty. (-B)`,
10206: `Topic with a maximum of 7 tags. Minimum one tag. (-B)`,
10207: `Topic with a maximum of 2 categories. Minimum one category. (-B)`,
10208: `Invalid topics timestamp. (-B)`,
// Auth Part
10301: `Sending emails too frequently, please waiting 30s (-B)`,
10302: `Invalid Email Format (-B)`,
10303: `Invalid Email, Password, or Verification Code Format (-B)`,
// Comment Part
10401: `Comment length exceed 1007 characters. Or empty. (-B)`,
// Reply Part
10501: `Reply with a maximum of 7 tags. (-B)`,
10502: `Single tag maximum length is 17 characters (-B)`,
10503: `Reply content is empty (-B)`,
10504: `Reply maximum length is 10007 characters (-B)`,
10505: `Invalid reply timestamp. (-B)`,
markdown
10101: `用户未找到 (-B)`,
10102: `用户密码错误 (-B)`,
10103: `邮箱验证码错误 (-B)`,
10104: `邮箱已被注册,请更改 (-B)`,
10105: `用户名已被注册,请修改 (-B)`,
10106: `用户签名过长 (-B)`,
10107: `非法的邮箱, 用户名, 密码, 或验证码 (-B)`,
10108: `非法的密码格式 (-B)`,
10109: `非法的邮箱或验证码格式 (-B)`,
10110: `头像上传错误. 图片为数组 (-B)`,
10111: `头像上传错误. 图片最终压缩大小超过 50kb (-B)`,
10112: `登陆冷却中,两次相同登陆时间间隔一分钟 (-B)`,
10201: `您今日可以发表的话题数已达上限 (-B)`,
10202: `您的萌萌点不足 1100, 无法使用推话题功能 (-B)`,
10204: `话题标题长度超过 40 个字符, 或为空 (-B)`,
10205: `话题内容长度超过 100007 个字符, 或为空 (-B)`,
10206: `话题最多 7 个标签, 最少一个标签 (-B)`,
10207: `话题最多 2 个分类, 最少一个分类 (-B)`,
10208: `非法的话题时间戳. (-B)`,
10301: `发送邮件频率过快, 请等待 30 秒 (-B)`,
10302: `非法的邮箱格式 (-B)`,
10303: `非法的邮箱, 密码, 或验证码 (-B)`,
10401: `评论内容长度超过 1007 个字符, 或为空 (-B)`,
10501: `回复最多 7 个标签 (-B)`,
10502: `单个标签最长 17 个字符 (-B)`,
10503: `回复内容不可为空 (-B)`,
10504: `回复内容最大长度为 10007 个字符 (-B)`,
10505: `非法的回复时间戳 (-B)`,