Java自定义异常类支持格式化参数，核心是重写构造方法并用String.format或MessageFormat在构造时完成消息解析，推荐继承RuntimeException或Exception，提供多参构造器，避免在getMessage()中动态计算。
Java中自定义异常类支持格式化参数（即动态替换错误信息），核心是重写构造方法，结合String.format或MessageFormat在构造时解析模板并填充参数，同时确保异常消息可读、可调试、可国际化。
定义带格式化能力的自定义异常类
推荐继承RuntimeException（运行时异常）或Exception（检查异常），并在构造方法中处理占位符。关键点：异常消息应在构造时完成格式化，而不是延迟到getMessage()中动态计算（避免重复解析或线程安全问题）。
- 提供多个构造器：无参、仅消息字符串、消息模板+参数数组、带cause的版本
- 使用
String.format处理%s、%d等占位符（简单直接，类型安全需靠调用方保证） - 若需更复杂的占位符（如
{0}、{name}），可用MessageFormat或第三方库（如SLF4J的StringFormatter）
标准实现示例（基于String.format）
以下是一个生产可用的模板异常类：
<font color="#888">// 示例：业务异常，支持格式化</font>
public class BusinessException extends RuntimeException {
public BusinessException(String message, Object... args) {
super(String.format(message, args));
}
public BusinessException(String message, Throwable cause, Object... args) {
super(String.format(message, args), cause);
}
public BusinessException(Throwable cause) {
super(cause);
}
}
调用方式清晰直观：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
BizException e = new BusinessException("用户 %s 余额不足，当前余额：%d", "张三", 150);
抛出后e.getMessage()返回："用户 张三 余额不足，当前余额：150"
增强版：支持命名参数与类型安全（可选）
若需类似"用户名 {name} 不存在，ID={id}"这种命名占位符，可引入轻量工具：
- 使用
org.apache.commons.text.StringSubstitutor（Apache Commons Text）做键值替换 - 或手动解析Map参数，配合正则替换（注意避免注入风险，只允许预定义键）
- 不建议在异常类中硬编码复杂模板引擎（如Velocity），增加依赖且无必要
简易命名替换示例（不依赖外部库）：
public class NamedBizException extends RuntimeException {
public NamedBizException(String template, Map<String, Object> params) {
super(substitute(template, params));
}
private static String substitute(String template, Map<String, Object> params) {
String result = template;
for (Map.Entry<String, Object> entry : params.entrySet()) {
result = result.replace("{" + entry.getKey() + "}",
String.valueOf(entry.getValue()));
}
return result;
}
}
调用：new NamedBizException("订单 {id} 状态异常：{reason}", Map.of("id", "ORD-1001", "reason", "超时"))
注意事项与最佳实践
- 异常消息应简洁明确，避免在模板中拼接敏感信息（如密码、token）
- 参数对象需保证
toString()有意义；对null值做防御性处理（例如用Objects.toString(obj, "null")） - 日志记录时，优先打印完整异常栈，而不仅是
getMessage()，便于排查上下文 - 如需国际化，不要在异常类中硬编码资源绑定，而是将模板键（如
"error.user.not.found"）传入，由上层统一翻译
