Spring Boot中Thymeleaf的#authentication始终为null问题求助

1. 确认依赖版本匹配 #

确保thymeleaf-extras-springsecurity版本与Spring Boot、Spring Security版本完全兼容：

• Spring Boot 3.x（对应Spring Security 6.x）：使用thymeleaf-extras-springsecurity6
• Spring Boot 2.7.x（对应Spring Security 5.x）：使用thymeleaf-extras-springsecurity5
• Spring Boot 2.6及以下：使用thymeleaf-extras-springsecurity4

Maven依赖示例（Spring Boot 3.x）：

<dependency>
    <groupId>org.thymeleaf.extras</groupId>
    <artifactId>thymeleaf-extras-springsecurity6</artifactId>
</dependency>

2. 检查Thymeleaf页面命名空间 #

必须在HTML根标签中添加Spring Security专属命名空间，否则sec:属性会被当作普通HTML属性忽略：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org"
      xmlns:sec="http://www.thymeleaf.org/extras/spring-security">
<!-- 页面内容 -->
</html>

3. 手动注册Spring Security方言Bean（自动配置失效场景） #

若依赖正确但自动配置未生效，在配置类中手动注册方言：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.thymeleaf.extras.springsecurity6.dialect.SpringSecurityDialect;

@Configuration
public class ThymeleafConfig {
    @Bean
    public SpringSecurityDialect springSecurityDialect() {
        return new SpringSecurityDialect();
    }
}

4. 验证SecurityContext线程传播 #

确认Thymeleaf渲染时，当前线程SecurityContextHolder中存在认证信息：

• 避免在异步线程中渲染页面（异步线程默认不继承父线程SecurityContext）
• 若使用JWT等无状态认证，确保拦截器/过滤器已将认证信息存入SecurityContextHolder，且采用默认的THREAD_LOCAL存储策略

5. 检查Spring Security忽略规则 #

确保模板路径（/templates/**）未被Spring Security的ignoring()方法排除，否则Thymeleaf无法获取认证上下文：

@Configuration
public class SecurityConfig {
    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http
            .authorizeHttpRequests(auth -> auth
                .anyRequest().authenticated()
            );
        return http.build();
    }
}

6. 测试最简验证页面 #

创建极简页面排除其他代码干扰，验证基础功能：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org"
      xmlns:sec="http://www.thymeleaf.org/extras/spring-security">
<body>
    <div sec:authorize="isAuthenticated()">已登录</div>
    <div sec:authorize="isAnonymous()">未登录</div>
    <p>认证信息：<span th:text="${#authentication}"></span></p>
</body>
</html>

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