在 Thymeleaf 模板中引用 Java 多级静态嵌套类（如 L1.L2.L3.MyEnum）时，需使用 $ 符号替代 . 作为嵌套层级分隔符，否则会因类名解析失败导致 EL1005E 错误。
在 thymeleaf 模板中引用 java 多级静态嵌套类（如 `l1.l2.l3.myenum`）时，需使用 `$` 符号替代 `.` 作为嵌套层级分隔符，否则会因类名解析失败导致 el1005e 错误。
Thymeleaf 的 T() 表达式用于在模板中引用 Java 类型（如静态方法、常量或枚举值），其内部依赖标准的 Java 类名解析机制。而 Java 编译器对嵌套类（尤其是静态内部类）生成的二进制类名（binary name） 并非使用点号 . 分隔，而是采用美元符号 $ 连接外层类与内层类。例如：
public class L1 {
public static class L2 {
public static class L3 {
public enum MyEnum { E1, E2, E3 }
}
}
}运行以下代码可验证实际类名：
System.out.println(L1.L2.L3.MyEnum.class.getName()); // 输出示例：com.my.packages.L1$L2$L3$MyEnum
因此，在 Thymeleaf 中必须严格匹配该二进制类名格式，不能写作 L1.L2.L3.MyEnum（这是源码中的可读形式，非运行时类名），而应写作：
<!-- ✅ 正确：使用 $ 分隔嵌套层级 -->
<span th:text="${T(com.my.packages.L1$L2$L3$MyEnum).E1}">E1</span>
<!-- ✅ 也可接受（部分 Thymeleaf 版本兼容）：最外层包用 .，嵌套类用 $ -->
<span th:text="${T(com.my.packages.L1$L2$L3.MyEnum).E1}">E1</span>⚠️ 注意事项：
- . 仅用于表示包路径分隔符；$ 才是 JVM 规范定义的嵌套类分隔符（见 JVM Spec §4.2.1）。
- 非静态内部类（即成员内部类）无法直接通过 T() 引用，因其构造依赖外部类实例，Thymeleaf 不支持此类上下文绑定。
- 若嵌套类未声明为 public static，则可能因可见性问题导致 ClassNotFoundException，请确保所有中间类（L2, L3）及目标类型（MyEnum）均为 public static。
- 在 Spring Boot + Thymeleaf 环境中，若仍报错，请检查类是否被正确编译并包含在 classpath 中（可通过 IDE 查看反编译后的 .class 文件名确认）。
✅ 最佳实践建议：
-
在复杂嵌套场景下，优先在 Controller 或 @ControllerAdvice 中将枚举值或类型预注入 Model，避免模板中硬编码长类名：
model.addAttribute("MyEnum", L1.L2.L3.MyEnum.class);模板中即可简洁使用：
<span th:text="${T(#vars['MyEnum']).E2}"></span> 如项目允许，可考虑将深层嵌套枚举提升至顶层（如 MyEnum → com.my.packages.MyEnum），兼顾可维护性与模板简洁性。
掌握 $ 与 . 的语义差异，是安全、高效使用 Thymeleaf 类型表达式的关键基础。
