能否修改Java Exception报错信息返回类型，以抛出包含错误详情的HashMap？

需求实现方案 #

完全可以实现，你不需要放弃抛出异常的逻辑，只需要自定义业务异常类即可，Java允许自定义异常携带任意类型的成员变量。

1. 自定义ToolX异常类 #

你可以直接继承RuntimeException（非受检异常，不需要显式声明抛出）或者Exception（受检异常，需要显式throws），在异常类中添加专门存储错误明细的HashMap字段即可，示例代码如下：

import java.util.HashMap;

public class ToolXException extends RuntimeException {
    // 存储自定义的全量错误明细
    private final HashMap<String, Object> errorDetail;

    // 构造方法直接接收HashMap作为入参
    public ToolXException(HashMap<String, Object> errorDetail) {
        // 可选：将顶层错误提示传入父类的默认message字段，方便日志打印
        super((String) errorDetail.getOrDefault("Message", "工具参数校验不通过"));
        this.errorDetail = errorDetail;
    }

    // 对外提供获取错误明细的方法
    public HashMap<String, Object> getErrorDetail() {
        return errorDetail;
    }
}

2. 异常抛出逻辑 #

你期望的抛出写法完全可以直接使用，不需要修改：

if (errorHashMap != null) {
  throw new ToolXException(errorHashMap);
}

3. 异常捕获与返回处理 #

上层逻辑捕获该异常后，直接调用getErrorDetail()方法即可拿到完整的错误HashMap，序列化后返回给客户端即可：

try {
    // 执行工具业务逻辑
    executeInternalTool(params);
} catch (ToolXException e) {
    // 直接取出错误明细，转JSON返回给客户端
    HashMap<String, Object> resp = e.getErrorDetail();
    // 后续返回逻辑省略...
}

优化建议 #

如果你使用的是SpringBoot等Web框架，可以搭配全局异常处理器使用，不需要在每个接口中手动捕获该异常：

• 新增@RestControllerAdvice注解的全局异常处理类
• 编写专门处理ToolXException的方法，直接将errorDetail作为接口返回值返回，框架会自动序列化为JSON格式

如果你对类型安全有要求，也可以把HashMap替换为自定义的错误结构POJO类，避免因键名拼写错误导致的问题，使用逻辑和HashMap完全一致。

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