AgileBoot – 项目内统一的错误码设计

统一的错误码管理的优点

1. 统一的错误码描述，如果没有统一的错误码的话，错误描述散落在项目内的不同地方，同一个错误码却产生不同的错误描述，会导致歧义。
2. 错误码的层级，在与客户端的交互过程中，我们可能需要根据错误的层级，来做不同的显示。例如系统内部的错误，我们产生红色的警告框。业务上操作类型的错误（例如用户名不能超过64位），我们
   则以正常的黄色提示框来提醒用户。
3. i18n的处理。统一的错误码管理，才使得国际化更好实现。我们可以给每一种错误码定义唯一的key，来找到对应不同语言的错误描述。
4. 集中的错误码管理便于形成文档供调用者参考。例如我们提供接口给其他团队调用，可以提供给他们详细的错误码列表。

无错误码设计的缺陷

Ruoyi项目

1. 错误描述散落在项目的各个地方，一旦有改变错误描述的需求，要满项目去寻找关联的错误描述，然后逐一修改。这种情形很容易造成疏漏。
2. 如果需要翻译的话，这种随意的字符串形式也很难去做国际化翻译。
3. 没有准确的错误码，在一些情形下，调用方需要根据你返回的错误码进行不同的处理。如果没有准确的错误码，仅凭错误描述，比较难以实现。

错误码的层级

错误码的层级有助于客户端对于不同级别的错误进行处理。比如有的错误进行隐藏，有的错误直接暴露给用户。这边我规划了四层错误码。
错误码集合

• 1~9999 为保留错误码 或者 常用错误码
• 10000~19999 为内部错误码
• 20000~29999 客户端错误码 （客户端异常调用之类的错误）
• 30000~39999 为第三方错误码 （代码正常，但是第三方异常）
• 40000~49999 为业务逻辑 错误码 （无异常，代码正常流转，并返回提示给用户）

错误码的模块

为了更好的分门别类，笔者给错误码设定了模块，便于客户端的特殊处理。例如客户端可以专门给某一个模块的错误进行一个统一的处理。
模块对应的数字在千位和百位。例如1XX01，XX代表了模块的意义。

/**
 * 系统内的模块
 */
public enum Module {

    /**
     * 普通模块
     */
    COMMON(0),

    /**
     * 权限模块
     */
    PERMISSION(1),

    /**
     * 登录模块
     */
    LOGIN(2),

    /**
     * 数据库模块
     */
    DB(3),

    /**
     * 上传
     */
    UPLOAD(4),

    /**
     * 用户
     */
    USER(5),

    /**
     * 配置
     */
    CONFIG(6),

    /**
     * 职位
     */
    POST(7),

    ;


    private final int code;

    Module(int code) { this.code = code * 100; }

    public int code() {return code; }

}

错误码代码例子

/**
     * 10000~19999是内部错误码  例如 框架有问题之类的
     */
    public enum Internal implements ErrorCodeInterface {
        /**
         * 内部错误码
         */
        INVALID_PARAMETER(Module.COMMON, 1, "参数异常"),

        UNKNOWN_ERROR(Module.COMMON, 2, "未知异常, 请查看系统日志"),

        GET_ENUM_FAILED(Module.COMMON, 3, "获取枚举类型失败, 枚举类: {}"),

        GET_CACHE_FAILED(Module.COMMON, 4, "获取缓存失败"),

        LOGIN_CAPTCHA_GENERATE_FAIL(Module.LOGIN, 1, "验证码生成失败"),

        INVALID_TOKEN(Module.PERMISSION, 1, "token异常"),

        DB_INTERNAL_ERROR(Module.DB, 1, "数据库异常: {}"),

        ;

        private final int code;
        private final String msg;

        private static final int BASE_CODE = 10000;

        Internal(Module module, int code, String msg) {
            this.code = BASE_CODE + module.code() + code;
            this.msg = msg;
        }

        @Override
        public int code() {
            return this.code;
        }

        @Override
        public String message() {
            return this.msg;
        }

    }

错误码的使用

为了便于错误码在编写代码时方便使用，我创建了ErrorCode这个类，并将四个层级的错误类一并放进这个类当中。

本站声明：
1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享；

2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关；

3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关；

4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除；

5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。