Spring Boot中Thymeleaf无法识别全局变量，加抑制注释后部分功能失效原因

问题原因分析 #

1. IDE提示变量未解析的原因 #

IntelliJ IDEA等IDE的Thymeleaf静态检查默认只会识别单个Controller接口中通过Model添加的属性，不会主动扫描@ControllerAdvice全局注入的@ModelAttribute变量，所以会误报未解析错误，这个提示本身不影响代码实际运行。
你添加的<!--suppress ThymeleafVariablesResolveInspection -->只是关闭了IDE的静态检查，和后续功能异常没有直接关系，功能异常是你的代码本身存在逻辑缺陷。

2. 部分功能无法正常运行的原因 #

核心问题是Model变量注入不全：
你在sharedData方法中，只有当session中存在cart对象时，才会往Model中添加csize、ctotal两个变量，当session中没有购物车数据时，这两个变量根本不存在。
虽然你在外层加了th:if="${cartActive}"控制购物车有数据的块是否显示，但Thymeleaf的表达式解析优先级高于条件判断，即使外层条件不成立，块内的${csize}、${ctotal}表达式依然会被解析，此时变量不存在就会触发运行时渲染错误，导致功能异常。

另外你模板中th:if="${notCartViewPage == null}"的逻辑存在歧义，如果调用该fragment的Controller没有传入notCartViewPage变量，该条件会永远成立，如果你是想实现“不在购物车详情页显示该购物车块”的逻辑，需要确保调用该fragment时传入对应的标识变量，避免逻辑不符合预期。

修复方案 #

不管session中是否有购物车数据，都给csize、ctotal设置默认值，保证Model中始终存在这两个变量即可：

// 放在cart判断之前初始化默认值
model.addAttribute("csize", 0)
model.addAttribute("ctotal", 0.0)
var cartActive = false
if (session.getAttribute("cart") != null) {
    // 原有计算逻辑覆盖默认值即可
    val cart: HashMap<Int, Cart> = session.getAttribute("cart") as HashMap<Int, Cart>
    var size = 0
    var total = 0.0
    for (value in cart.values) {
        size += value.quantity
        total += value.quantity * value.price.toDouble()
    }
    model.addAttribute("csize", size)
    model.addAttribute("ctotal", total)
    cartActive = true
}

如果你觉得IDE的未解析提示碍眼，不需要加全局抑制注释，可以在IDEA设置中开启Spring Boot Thymeleaf 支持，或者在每个全局变量表达式旁加局部抑制注释即可，不影响代码运行。

内容的提问来源于stack exchange，提问作者Mama