Servlet如何向客户端通知错误？两种实现方案哪种更优？

两种方案优劣势对比 #

方案1：服务层捕获异常返回统一结果对象 #

• 优势
  • 灵活性高：同一异常类型可根据不同业务场景返回个性化状态码、错误提示，比如参数校验错误在用户注册和订单提交场景下可返回针对性提示，便于前端展示友好的业务相关信息
  • 逻辑内聚：业务错误处理与业务逻辑耦合在同一层级，问题排查无需跳转至全局异常处理组件，业务代码可读性更强
  • 扩展成本低：统一返回的Message结构可按需扩展业务错误码、错误详情、前端跳转路径等字段，无需改动全局配置
• 劣势
  • 代码冗余：多个业务Service都需要编写重复的try-catch逻辑，大量模板代码拉低开发效率
  • 异常兜底能力弱：若开发人员遗漏捕获某类异常，异常会直接抛给Servlet容器，返回默认错误页，与前后端约定的返回格式不统一，前端无法正常解析

方案2：全局异常Servlet统一处理 #

• 优势
  • 代码简洁：业务层无需编写重复的异常捕获逻辑，可专注于核心业务实现，整体代码量更少
  • 兜底能力强：所有未被捕获的异常都会进入统一处理逻辑，不会出现返回格式不一致的问题，前端可统一适配错误解析规则
• 劣势
  • 灵活性不足：同一异常类型只能返回统一的状态码和提示信息，无法区分同类型异常在不同业务场景下的差异，返回的错误提示过于笼统，用户体验差
  • 配置成本高：新增异常类型需要逐个在web.xml中添加配置，异常匹配规则维护繁琐，且若异常被上层代码吞掉则无法触发全局处理逻辑

实际项目推荐方案 #

纯方案1或方案2都存在明显缺陷，更推荐两者结合的折中实现：

1. 业务层的可控异常直接抛出携带自定义业务码、错误提示的自定义业务异常，无需在Service层捕获包装为Message对象
2. 全局异常Servlet统一处理所有异常：针对自定义业务异常直接取出携带的状态码、提示信息返回；针对JDK标准异常（如IllegalArgumentException、NullPointerException）统一返回对应HTTP状态码和通用提示；最后添加Exception级别的兜底规则，返回500状态码和系统错误通用提示
3. 所有返回值统一使用JSON格式，不要返回纯文本，便于React前端统一解析，参考返回结构如下：

{
  "code": 400,
  "msg": "参数格式错误，请检查输入",
  "data": null
}

如果是小型项目、业务场景单一，直接使用方案2即可满足需求；如果是中大型项目、业务场景复杂，优先选择上述折中方案，兼顾灵活性与代码简洁性。

内容的提问来源于stack exchange，提问作者stavatar202110