应用错误码设计规范

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

1.什么是错误码?

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

2.错误码的作用

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

3.错误码规范

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

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

  • 系统标志: 3-5位字符串,例如AppNmae
  • 应用标志:3位数字,标志应用,例如001
  • 功能域:3位数字,标志功能板块,例如001表示登陆
  • 错误类型:1位字母,代表错误的类型,例如B-业务错误,P-参数错误,N-网络错误,D-数据库错误,F-文件IO错误,O-其他错误
  • 错误编码:三位数字,代表特定的错误含义
相关文章
|
算法 JavaScript 大数据
高德地图 错误码说明 对照表
序号  infocode info返回值 状态描述 问题排查策略 1 10000 OK 请求正常 请求正常 2 10001 INVALID_USER_KEY key不正确或过期 开发者发起请求时,传入的key不正确或者过期  3 10002 SERVICE_NOT_AVAILABLE 没有权限使用相应的服务或者请求接口的路径拼写错误 1.开发者没有权限使用相应的服务,例如:开发者申请了WEB定位功能的key,却使用该key访问逆地理编码功能时,就会返回该错误。反之亦然。2.开发者请求接口的路径拼写错误。例如:正确的https://restapi.amap.com/v3/ip在程序中被拼装写了h
1266 0
|
监控 前端开发 Java
错误码如何设计才合理?
对于错误码的设计,不同的开发团队有不同的风格习惯。本文分享阿里文娱技术专家长统对于错误码的看法,希望从错误码使用的不同场景讨论得到一个合理的错误码规约,得到一个面向日志错误码标准和一个面向外部传递的错误码标准。
10432 3
错误码如何设计才合理?
|
3月前
|
IDE Java 开发工具
Java系统中的错误码设计问题之为Java项目中的错误消息提供国际化支持如何解决
Java系统中的错误码设计问题之为Java项目中的错误消息提供国际化支持如何解决
46 0
|
2月前
|
监控 前端开发 API
错误码设计规范探索
本文介绍了错误码设计规范,包括模块化分层、错误码结构及定义、可扩展性与可维护性等方面。错误码用于标识程序中的特定错误,便于快速定位和解决。文中详细描述了全局通用错误码和业务错误码的设计方法,并提出了5-6位数字编码方案,确保错误码的唯一性和可读性。同时,强调了错误码与日志系统的集成及多语言支持的重要性,提供了多个参考文献供进一步学习。
165 2
|
22天前
|
Prometheus 监控 Cloud Native
调用淘宝 API 时如何处理错误信息?
调用淘宝API时,需熟悉其错误码体系,处理客户端(如参数错误、权限不足)和服务器(如内部错误、网络问题)错误,编写错误处理逻辑,并进行充分测试与监控,确保API调用稳定可靠。
|
26天前
|
API
阿里云短信平台API错误码提示错误天级流控显示小时级错误码
阿里云短信平台API错误码提示错误天级流控显示小时级错误码
|
3月前
|
JSON Java 对象存储
Java系统中的错误码设计问题之ProblemBuilder构建错误如何解决
Java系统中的错误码设计问题之ProblemBuilder构建错误如何解决
23 1
|
6月前
|
程序员
程序员为何对需求变更心存畏惧?
在当今日新月异的软件开发行业中,在快速变化、充满不确定性的软件开发行业中,项目的复杂性和动态性日益增加,而其中一个始终绕不开的话题就是需求变更,需求变更几乎成为了家常便饭。对于大部分程序员而言,面对需求的调整或修改,往往会产生一种普遍的“畏惧感”,这种心理反应并非空穴来风,而是由多方面因素共同作用的结果。所以说尽管这是行业常态,但程序员们对于需求变更的反应却往往带有明显的紧张与谨慎。那么本文就来简单聊聊关于程序员为什么对需求变更“心存畏惧”,也欢迎大家在评论区留言交流。
63 2
程序员为何对需求变更心存畏惧?
|
4月前
|
运维 Kubernetes API
阿里云云效操作报错合集之API返回的错误信息,错误码为"Operate.NoPermission",该如何解决
本合集将整理呈现用户在使用过程中遇到的报错及其对应的解决办法,包括但不限于账户权限设置错误、项目配置不正确、代码提交冲突、构建任务执行失败、测试环境异常、需求流转阻塞等问题。阿里云云效是一站式企业级研发协同和DevOps平台,为企业提供从需求规划、开发、测试、发布到运维、运营的全流程端到端服务和工具支撑,致力于提升企业的研发效能和创新能力。
|
12月前
|
Cloud Native Linux Go
听说你还在自己做重复劳动?看我一键生成错误码映射
听说你还在自己做重复劳动?看我一键生成错误码映射