Spring Boot+Thymeleaf全局属性无法在页脚显示的解决方法

可能原因及对应解决方案 #

1. 确认@ControllerAdvice作用范围覆盖页面控制器 #

默认@ControllerAdvice会作用于所有Spring管理的@Controller和@RestController，但如果页面控制器与GlobalController不在同一扫描路径下，需显式指定作用范围：

@ControllerAdvice(basePackages = "com.yourpackage.web") // 替换为你的页面控制器所在包
public class GlobalController {
    @ModelAttribute("service_version")
    public String getVersion() {
        return "version 1.0.0";
    }
}

2. 验证GlobalController是否被Spring加载 #

@ControllerAdvice本身包含@Component，但需确保它在Spring组件扫描路径内。可通过添加日志或断点验证getVersion()方法是否被调用：

@ControllerAdvice
public class GlobalController {
    private static final Logger logger = LoggerFactory.getLogger(GlobalController.class);
    
    @ModelAttribute("service_version")
    public String getVersion() {
        logger.info("Loading service version: 1.0.0");
        return "version 1.0.0";
    }
}

启动服务后访问任意页面，若控制台未输出该日志，说明GlobalController未被扫描，需调整包路径或在启动类上添加@ComponentScan指定扫描范围。

3. 检查是否存在同名属性覆盖 #

若某个页面控制器中也定义了service_version属性（值为null或空），会覆盖全局属性。检查所有控制器代码，避免出现以下类似逻辑：

@Controller
public class HomeController {
    @ModelAttribute("service_version") // 此属性会覆盖全局值
    public String localVersion() {
        return "";
    }
}

4. 确认Thymeleaf片段引用方式正确 #

确保页面引用页脚片段时使用规范语法，保证上下文正常传递：

<!-- 推荐的引用方式 -->
<th:block th:replace="~{layout :: page_footer}" />
<!-- 或 -->
<div th:insert="~{layout :: page_footer}"></div>

5. 校验表达式拼写一致性 #

确认Thymeleaf片段中的表达式${service_version}与@ModelAttribute的名称完全匹配（注意大小写和下划线）：

<span th:text="${service_version}"></span>

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