Thymeleaf 默认不支持用点号（.）访问 Java 多层静态嵌套类，必须改用美元符（$）作为内部类分隔符，否则会抛出“Type cannot be found”错误。
thymeleaf 默认不支持用点号（`.`）访问 java 多层静态嵌套类，必须改用美元符（`$`）作为内部类分隔符，否则会抛出“type cannot be found”错误。
在 Spring Boot 项目中使用 Thymeleaf 时，若需在模板中引用深度嵌套的静态类（如 L1.L2.L3.MyEnum），直接沿用 Java 包路径风格的 ${T(com.my.packages.L1.L2.L3.MyEnum).E1} 写法必然失败——这是因为 Thymeleaf 的 T() 表达式底层依赖 JVM 的类加载机制，而 Java 编译器对嵌套类生成的二进制类名并非使用 . 分隔，而是采用 $ 符号。
例如，对于如下定义：
package com.my.packages;
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（注意：$ 是 JVM 规范定义的嵌套类分隔符，. 仅用于包层级）。
因此，在 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>⚠️ 注意：L3.MyEnum 混合写法虽在某些环境下可工作，但本质是 Thymeleaf 解析器的宽松容错行为，不可靠且不推荐。应统一使用 $ 替换所有嵌套层级分隔符。
? 验证技巧：
可在 Controller 中打印 L1.L2.L3.MyEnum.class.getName() 或通过 Class.forName("com.my.packages.L1$L2$L3$MyEnum") 测试类是否可被 JVM 正确加载，确保路径无拼写/大小写/包名错误。
? 总结关键原则：
- . 仅用于包名分隔（如 com.my.packages）；
- $ 专用于编译后嵌套类分隔（L1$L2$L3$MyEnum）；
- 不要尝试“扁平化”路径（如省略某级），JVM 类名必须精确匹配；
- 静态内部类、静态嵌套枚举、匿名类等均遵循此规则；
- 若仍报错，请检查类是否为 public static（非静态内部类无法通过 T() 访问）、是否已正确编译进 classpath、以及 Thymeleaf 版本是否 ≥ 3.0（旧版可能存在解析限制）。
