讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

updream

一键生成高质量推广成片

Java 自定义异常中怎么映射到前端错误码

夜磊同学_7238

夜磊同学_7238

发布时间:2026-11-16 11:12:10

|

360人浏览过

|

来源于php中文网

原创

java 自定义异常映射到前端错误码的核心做法是定义一个包含业务状态码和描述信息的统一异常基类,并在 web 层通过全局异常处理器拦截该异常,将其转换为前端约定的 json 格式响应。具体实现时,需要确保异常对象能携带具体的错误码(如 http 400、500 或自定义业务码),控制器advice 捕获异常后提取这些字段并构建标准返回体,这样前端就能根据统一的 json 结构解析出错误信息。

Java 自定义异常中怎么映射到前端错误码

如何设计支持错误码的自定义异常基类

设计自定义异常的关键在于继承 RuntimeException 并扩展用于存储错误码和消息的字段。通常的做法是创建一个抽象基类 BaseException,它接受错误码、消息以及可选的原始异常作为参数。子类只需调用父类构造函数传入特定的业务错误码即可。这种设计确保了所有业务异常都遵循相同的契约,便于后续的统一处理。例如,定义一个 BusinessException 继承自 BaseException,当业务逻辑出错时抛出该异常,并传入对应的错误码如 1001 表示参数错误。

Java 自定义异常中怎么映射到前端错误码

public class BaseException extends RuntimeException {
    private final String errorCode;
    private final String message;

    public BaseException(String errorCode, String message) {
        super(message);
        this.errorCode = errorCode;
        this.message = message;
    }

    public String getErrorCode() {
        return errorCode;
    }

    public String getMessage() {
        return message;
    }
}

上述代码展示了基础结构的实现。在实际使用中,开发者可以定义更具体的异常类,如 UserNotFoundException,其构造函数直接调用 super("USER_NOT_FOUND", "用户不存在")。这样在业务层抛出异常时,就自动携带了前端需要的结构化数据。注意不要在这里处理 HTTP 状态码,因为那是 Web 层的职责,异常类只负责承载业务语义。

立即学习“Java免费学习笔记(深入)”;

Build Java agent transport gateways with Atmosphere
Build Java agent transport gateways with Atmosphere

使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

下载

如何通过全局异常处理器转换响应格式

在 Spring Boot 等框架中,使用 @RestControllerAdvice 配合 @ExceptionHandler 是实现映射的标准方式。处理器方法接收自定义异常实例,从中提取错误码和消息,然后构造一个包含 code、message 和 data 字段的通用响应对象。对于未捕获的异常,可以提供默认的错误码如 500。这种方式将异常处理逻辑与业务逻辑彻底分离,保证了 Controller 层的整洁。同时,可以根据异常类型设置不同的 HTTP 状态码,例如 BusinessException 通常对应 200 OK 但内部 code 非零,而系统异常可能对应 500。

Java 自定义异常中怎么映射到前端错误码

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(BaseException.class)
    public ResponseEntity<ApiResponse> handleBaseException(BaseException ex) {
        ApiResponse response = new ApiResponse();
        response.setCode(ex.getErrorCode());
        response.setMessage(ex.getMessage());
        response.setData(null);
        return ResponseEntity.ok(response);
    }

    @ExceptionHandler(Exception.class)
    public ResponseEntity<ApiResponse> handleException(Exception ex) {
        ApiResponse response = new ApiResponse();
        response.setCode("SYSTEM_ERROR");
        response.setMessage("系统内部错误");
        response.setData(null);
        return ResponseEntity.status(500).body(response);
    }
}

class ApiResponse {
    private String code;
    private String message;
    private Object data;
    // getters and setters
}

这段代码展示了完整的处理流程。当抛出 BaseException 时,handleBaseException 会被触发,返回 HTTP 200 但 body 中包含业务错误码。如果抛出其他 Exception,则进入兜底处理,返回 500 状态码。前端接收到响应后,检查 code 字段即可判断是否成功。若 code 为 SYSTEM_ERROR 或自定义业务码,则展示相应提示。这种机制确保了错误信息的标准化传递。

如何处理嵌套异常中的错误码提取

在实际开发中,自定义异常往往是由底层异常包装而成的,例如数据库操作失败导致 DataAccessException,进而被业务层包装为 BusinessException。此时,需要从嵌套的 cause 链中提取最原始的异常信息,或者保留顶层异常的错误码。如果希望保留原始异常的堆栈信息以便调试,可以在 BaseException 中增加 getCause() 的重写,但在映射到前端时,通常只关心顶层异常定义的 errorCode。若底层异常也携带了业务错误码,可以选择合并或优先使用顶层码。例如,当 UserService 捕获 SQLException 并抛出 BusinessException("DB_ERROR", "数据库连接失败") 时,前端看到的是 DB_ERROR,而不是底层的 SQL 异常细节。这种做法保护了系统内部实现细节,同时提供了清晰的业务指引。

热门AI工具

更多
讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

3043

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

6663

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

7490

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

7438

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

1063

2024.05.22

java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

12717

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

9802

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

8332

2023.07.31

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

120

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn