Java错误信息模板化核心是抽离固定提示语为可复用模板并动态填充，通过ResourceBundle支持多语言，封装自定义异常类统一组装消息，结合String.format或文本块提升可读性，并在日志中补全上下文增强排查能力。

Java 中实现错误信息模板化，核心是把固定结构的提示语抽离成可复用的模板，再结合动态参数填充生成最终异常消息。不是简单拼字符串，而是让错误描述具备一致性、可维护性和扩展性。

用 ResourceBundle 管理多语言模板

适合面向国际用户或需支持中英文切换的系统。将错误码与模板存入 properties 文件，运行时按 Locale 加载：

• 在 src/main/resources/i18n/messages_zh_CN.properties 中写：
  error.user.not.found=用户 {0} 未找到，请确认输入是否正确
• 在 messages_en_US.properties 中写：
  error.user.not.found=User {0} not found. Please check your input.
• 抛异常时用 MessageFormat.format(bundle.getString("error.user.not.found"), userId) 填充

封装自定义异常类统一组装消息

当多个业务点抛出同类错误（如“库存不足”），建议封装异常类，在构造器里完成模板拼接：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 定义 InventoryShortageException，继承 RuntimeException
• 构造器内调用 super(String.format("[%s] 库存不足，商品ID：%d，当前余量：%d", "INVENTORY-001", skuId, stock))
• 可额外提供 getErrorCode()、getSkuId() 等方法，方便日志提取结构化字段

用 String.format 或文本块提升可读性

避免 "用户" + username + "不存在" 这类易错拼接。推荐方式：

立即学习“Java免费学习笔记（深入）”；

• 简单场景：直接 throw new IllegalArgumentException(String.format("订单状态非法：%s，期望：%s", actual, expected))
• 复杂多行模板（Java 15+）：用文本块 + String.format，例如
  String msg = String.format("""
  [ORDER-003] 创建订单失败
  用户ID：%s
  商品SKU：%s
  时间：%s
  """, userId, sku, Instant.now());

配合日志上下文增强排查能力

模板化消息本身不解决排查问题，关键是在日志中补全上下文：

• 不要只写 log.error("下单失败", e)
• 应记录关键变量：log.error("下单失败，用户：{}，商品：{}，金额：{}", userId, sku, amount, e)
• 也可在异常类中内置 context 字段（如 Map<String, Object>），通过 toResponse() 方法输出结构化错误体