必须用static初始化块而非spring bean，因其依赖jvm类初始化机制，天然线程安全、一次执行、不依赖spring上下文，确保多模块独立启动时错误码字典仍可靠加载；应置于无框架依赖的common-core等底层模块，通过final+unmodifiablemap实现不可变共享。
在多模块大型 Maven 项目中，用 static 构建全局错误码字典，核心不是“加个 static 修饰”，而是借力 JVM 类加载机制的天然线程安全性和类初始化时机，让字典在首次使用时一次性、不可变、跨模块共享地加载完成——它不依赖 Spring 容器，不参与 Bean 生命周期，也不受模块启动顺序影响。
为什么必须用 static 初始化块，而不是 Spring Bean？
多模块项目中，各模块可能独立启动（如单元测试、集成测试、子服务单独运行），Spring 上下文未必完整或已就绪。而 static {} 属于 JVM 类初始化阶段，由 <clinit></clinit> 方法加锁保障，天然满足：
- 仅执行一次，且线程安全
- 类首次被主动引用（如调用
ErrorCodeDict.get("1001")）时触发，延迟但确定 - 不依赖任何框架，模块间无容器耦合，
common-core模块定义后，user-service或order-api可直接 import 使用
错误码字典应放在哪个模块？
必须置于最底层、无外部依赖的公共基础模块（如 common-core 或 shared-consts），并遵循：
- 该模块的
pom.xml中不引入 Spring、Web、DB 等任何业务相关依赖 - 只声明
java.base和必要工具类（如commons-lang3），确保可被任意模块无冲突引用 - 其他模块通过
<dependency></dependency>声明对该模块的 compile 范围依赖，而非 provided 或 runtime
正确实现：final + 不可变 + 配置驱动
避免把所有错误码硬编码在 Java 类里。推荐从 classpath 加载配置文件，并封装为不可变结构：
- 定义
ErrorCode接口或抽象基类，统一code()和message()行为 - 在
ErrorCodeDict类中声明public static final Map<string errorcode> ALL</string> - static 块内用
Properties读取/error-codes.properties，逐行构建StaticErrorCode实例 - 最终用
Collections.unmodifiableMap()封装，杜绝运行期修改 - 加载失败时抛出
ExceptionInInitializerError，让 JVM 中断类初始化——这是强校验，比静默 fallback 更利于早期发现问题
如何支持多模块差异化扩展？
全局字典保持稳定，模块专属错误码通过组合方式接入：
- 主字典只承载平台级通用错误码（如 0 成功、500 系统异常、401 未登录）
- 业务模块（如
payment-service）定义自己的PaymentErrorCode枚举或常量类，实现同一接口 - 需要合并时，用
Stream.concat(ALL.values().stream(), PaymentErrorCode.values().stream())动态组装（仅限调试或管理端），不破坏主字典不可变性 - 日志或监控上报时，统一走
ErrorCode.code()字符串，天然兼容跨模块识别
