jvm类初始化阶段通过方法加锁，确保static块仅执行一次且线程安全；配合final+unmodifiablemap实现不可变路由字典，启动即加载、全应用共享、运行期不变更。
用 static 静态初始化块构建核心路由分流字典，关键不是“写个 static{}”，而是借力 JVM 类加载机制的天然同步性，在类首次被主动使用时，一次性、线程安全地完成字典加载与不可变封装——它不依赖 Spring、不阻塞主线程、也不需要加锁。
适合放进去的路由字典特征
静态初始化块只适合承载那些启动即需、全应用共享、运行期绝不变更的路由规则。例如：
- HTTP 接口路径到业务处理器类名的映射（如 "/user/profile" → "UserProfileHandler"）
- 消息类型码（如 "MQ_ORDER_CREATED"）到消费者 Bean 名或 Class 的绑定
- 灰度标识前缀（如 "v2-"）到对应服务版本策略的预定义规则
- 地区代码（如 "CN", "US"）到默认路由权重或降级策略的常量表
正确写法：final + 手动加载 + 异常兜底
字典必须声明为 public static final，确保不可修改；加载逻辑要绕过 Spring，用原生方式读取 classpath 下的配置，并捕获所有异常：
public class RouteDictionary {
public static final Map
public static final Map
static {
Properties props = new Properties();
try (InputStream is = RouteDictionary.class.getResourceAsStream("/routes.properties")) {
if (is == null) {
throw new IllegalArgumentException("routes.properties not found");
}
props.load(is);
} catch (Exception e) {
throw new ExceptionInInitializerError("Failed to load route config", e);
}
// 构建不可变字典
PATH_TO_HANDLER = Collections.unmodifiableMap(new HashMap() {{
put("/api/user", props.getProperty("user.handler", "UserV1Handler"));
put("/api/order", props.getProperty("order.handler", "OrderV1Handler"));
}});
REGION_WEIGHTS = Collections.unmodifiableMap(new HashMap() {{
put("CN", Integer.parseInt(props.getProperty("cn.weight", "80")));
put("US", Integer.parseInt(props.getProperty("us.weight", "20")));
}});
}
}
为什么它线程安全且只执行一次
JVM 在类初始化阶段（<clinit></clinit>）对整个静态块加锁。多个线程同时首次调用 RouteDictionary.PATH_TO_HANDLER 时，只有一个线程进入初始化，其余等待；初始化完成后，所有线程读到的都是同一份已构建好的不可变字典，无竞态、无重复加载。
避开典型陷阱
- 别在 static 块里调用 Spring 的
ApplicationContext.getBean()—— 此时容器尚未启动 - 别加载外部文件（如
/etc/app/routes.conf），路径不可靠，异常难定位 - 别做远程 HTTP 请求拉取路由规则 —— 会卡死类加载，导致后续所有使用该类的线程全部阻塞
- 别用
new ConcurrentHashMap()或可变集合赋值给 final 字段 —— 必须用Collections.unmodifiableMap封装
