应用错误码设计规范

简介: 提供错误码的设计规范建议

1.什么是错误码?

错误码是能够快速识别错误来源、具备特定意义、便于记忆和传阅的、标准化的一种设计.

2.错误码的作用

  • 通过错误码快速判断错误来源和错误原因,快速排查问题.
  • 应用程序之间通过错误码识别调用结果
  • 前端根据错误码进行错误提示或者其他适配操作
  • 根据错误码配置特定监控告警

3.错误码规范

  • 容易记忆和传阅
  • 有明确的类型区分
  • 可以明确区分来源
  • 所有系统均采用统一的标准
  • 不允许错误码直接通过前端展示给用户
  • 错误码与HTTP响应码区分开
  • 宁愿长一点,也要实现易记忆、含义明确

[系统标识]-[应用标志]-[功能域]-[错误类型]-[错误编码]

  • 系统标志: 3-5位字符串,例如AppNmae
  • 应用标志:3位数字,标志应用,例如001
  • 功能域:3位数字,标志功能板块,例如001表示登陆
  • 错误类型:1位字母,代表错误的类型,例如B-业务错误,P-参数错误,N-网络错误,D-数据库错误,F-文件IO错误,O-其他错误
  • 错误编码:三位数字,代表特定的错误含义
相关文章
|
JSON 负载均衡 前端开发
一文带你详细了解Open API设计规范
一文带你详细了解Open API设计规范
3912 1
|
存储 缓存 安全
API接口设计规范
这个是目前第三方数据接口交互过程中常用的一些参数与使用示例,希望对大家有点帮助。 当然如果为了保证更加的安全,可以加上RSA,RSA2,AES等等加密方式,保证了数据的更加的安全,但是唯一的缺点是加密与解密比较耗费CPU的资源.
|
监控 前端开发 Java
错误码如何设计才合理?
对于错误码的设计,不同的开发团队有不同的风格习惯。本文分享阿里文娱技术专家长统对于错误码的看法,希望从错误码使用的不同场景讨论得到一个合理的错误码规约,得到一个面向日志错误码标准和一个面向外部传递的错误码标准。
10630 3
错误码如何设计才合理?
|
2月前
|
API 开发者
提供一份 1688 商品详情接口的错误码及解决方法
本文介绍了 1688 商品详情接口常见的错误码及其解决方法,包括 401(未授权)、403(禁止访问)、404(未找到)、429(请求过多)和 500/502/504(服务器错误)。详细说明了每个错误码的含义及相应的解决步骤,帮助开发者快速定位并解决问题。
|
3月前
|
监控 前端开发 API
错误码设计规范探索
本文介绍了错误码设计规范,包括模块化分层、错误码结构及定义、可扩展性与可维护性等方面。错误码用于标识程序中的特定错误,便于快速定位和解决。文中详细描述了全局通用错误码和业务错误码的设计方法,并提出了5-6位数字编码方案,确保错误码的唯一性和可读性。同时,强调了错误码与日志系统的集成及多语言支持的重要性,提供了多个参考文献供进一步学习。
307 2
|
2月前
|
API
阿里云短信平台API错误码提示错误天级流控显示小时级错误码
阿里云短信平台API错误码提示错误天级流控显示小时级错误码
|
4月前
|
安全 API 数据安全/隐私保护
API 接口设计规范
API 接口设计规范
194 10
|
7月前
|
程序员
程序员为何对需求变更心存畏惧?
在当今日新月异的软件开发行业中,在快速变化、充满不确定性的软件开发行业中,项目的复杂性和动态性日益增加,而其中一个始终绕不开的话题就是需求变更,需求变更几乎成为了家常便饭。对于大部分程序员而言,面对需求的调整或修改,往往会产生一种普遍的“畏惧感”,这种心理反应并非空穴来风,而是由多方面因素共同作用的结果。所以说尽管这是行业常态,但程序员们对于需求变更的反应却往往带有明显的紧张与谨慎。那么本文就来简单聊聊关于程序员为什么对需求变更“心存畏惧”,也欢迎大家在评论区留言交流。
74 2
程序员为何对需求变更心存畏惧?
|
6月前
|
安全 API 数据安全/隐私保护
关于API安全设计5A原则
【6月更文挑战第1天】5A原则包括身份认证、授权、访问控制、可审计性和资产保护,是安全设计的核心要素。
|
7月前
|
小程序 定位技术 Android开发
小程序质量提升丨定位问题解决方案(错误码11)
小程序质量提升丨定位问题解决方案(错误码11)
118 6