java自定义异常应通过语义化命名、多参数构造方法、错误码分离提示与异常类、全局处理器统一响应，实现结构化、可定位、可翻译的友好错误处理。
Java 中自定义异常本身不直接包含“提示信息”的展示逻辑，但可以通过合理设计异常类、构造方法和调用方式，让错误信息对用户或日志更友好、更易理解。关键不是“抛出异常时写一句中文”，而是让异常携带结构化、上下文清晰、可定位、可翻译的信息。
1. 异常类命名体现业务语义
避免使用泛泛的 MyException 或 BusinessException。名称应明确反映问题本质，例如：
-
InsufficientBalanceException（余额不足） -
InvalidPromotionCodeException（优惠码无效） -
ExpiredSessionException（会话已过期）
命名即文档——看到类名就知道发生了什么，无需翻源码。
2. 构造方法支持多级信息注入
不要只依赖 super(message)。建议提供多种构造方式，把「技术原因」和「用户提示」分离：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 带错误码（
errorCode）：用于前端识别并映射国际化文案 - 带业务参数（如订单号、用户ID）：方便排查与关联上下文
- 可选嵌套原始异常（
cause）：保留底层堆栈，便于运维分析
示例：
public class InsufficientBalanceException extends RuntimeException {
private final String errorCode = "BALANCE_INSUFFICIENT";
private final String orderId;
public InsufficientBalanceException(String orderId) {
super("账户余额不足，无法完成订单：" + orderId);
this.orderId = orderId;
}
public InsufficientBalanceException(String orderId, Throwable cause) {
super("账户余额不足，无法完成订单：" + orderId, cause);
this.orderId = orderId;
}
public String getErrorCode() { return errorCode; }
public String getOrderId() { return orderId; }
}
3. 提示信息不硬编码在异常中，而由外部统一管理
异常对象应专注表达「发生了什么」，而非「怎么告诉用户」。真正的友好提示应由上层（如 Controller、Service 外围）决定：
- Web 层根据异常类型 + 错误码查资源包（
messages_zh_CN.properties），返回本地化文案 - 日志中记录异常全类名、错误码、关键参数（如
orderId=ORD-2024-789），不依赖 message 字符串解析 - 避免在
getMessage()里拼接敏感数据（如明文密码、完整身份证号）
4. 配合全局异常处理器统一响应格式
Spring Boot 中推荐用 @ControllerAdvice 拦截自定义异常，输出标准 JSON：
@ExceptionHandler(InsufficientBalanceException.class)
public ResponseEntity<apiresponse> handleInsufficientBalance(
InsufficientBalanceException e) {
String tip = messageSource.getMessage(
e.getErrorCode(),
new Object[]{e.getOrderId()},
LocaleContextHolder.getLocale());
return ResponseEntity.badRequest()
.body(ApiResponse.error(e.getErrorCode(), tip));
}
</apiresponse>
这样，异常类保持轻量，提示文案可配置、可审计、可多语言，也便于运营后台动态调整话术。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
