在 thymeleaf 模板中引用 java 多级静态嵌套类（如 l1.l2.l3.myenum）时，必须使用 $ 符号替代 . 作为嵌套层级分隔符，否则会因类名解析失败而抛出 “type cannot be found” 错误。
在 thymeleaf 模板中引用 java 多级静态嵌套类（如 l1.l2.l3.myenum）时，必须使用 $ 符号替代 . 作为嵌套层级分隔符，否则会因类名解析失败而抛出 “type cannot be found” 错误。
Thymeleaf 的 T() 表达式用于在模板中引用 Java 类型（如静态方法、常量或枚举值），其底层依赖于 Spring EL 对类名的解析机制。关键在于：Java 虚拟机对嵌套类的规范命名规则与源码中的点号写法并不等价。
当你定义如下嵌套结构时：
public class L1 {
public static class L2 {
public static class L3 {
public enum MyEnum {
E1, E2, E3
}
}
}
}该枚举类在 JVM 中的真实全限定类名为 com.my.packages.L1$L2$L3$MyEnum（注意是 $，而非 .）。可通过以下代码验证：
System.out.println(L1.L2.L3.MyEnum.class.getName()); // 输出示例：com.my.packages.L1$L2$L3$MyEnum
因此，在 Thymeleaf 模板中必须严格匹配 JVM 类名格式：
✅ 正确写法（推荐，完全匹配字节码类名）：
<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>⚠️ 注意：此写法依赖 Thymeleaf 的类名解析器对 . 和 $ 的混合处理，不具跨版本稳定性，强烈建议统一使用 $ 分隔所有嵌套层级。
❌ 错误写法（导致 EL1005E: Type cannot be found）：
<!-- ❌ 使用 . 分隔嵌套类 —— 解析失败 -->
<span th:text="${T(com.my.packages.L1.L2.L3.MyEnum).E1}">E1</span>实用建议与注意事项
- 命名一致性优先：始终以 Class.forName("...") 能成功加载的字符串为准，即 L1$L2$L3$MyEnum；
- 避免混淆包路径与嵌套层级：com.my.packages 是包名，用 .；L1$L2$L3$MyEnum 是类名，用 $；
- 静态内部类/枚举必须为 public static：非静态内部类（即持有外部类实例引用）无法被 Thymeleaf 直接引用；
- IDE 支持提示有限：多数 IDE 在 Thymeleaf 中对 T() 内部类名无智能补全，建议先在 Java 代码中确认 ClassName.class.getName() 输出；
- Spring Boot 用户注意版本兼容性：Thymeleaf 3.0+（配合 Spring Framework 5.0+）已稳定支持 $ 语法，旧版本需升级验证。
掌握这一区别，即可在不改动原有嵌套类结构的前提下，安全、准确地在模板中引用任意深度的静态嵌套类型。
