如何在Thymeleaf中获取Spring Security Principal数据？

问题背景 #

我们定义了自定义Principal实现类ApplicationUser，以及继承它的ApplicationUserDetails作为Spring Security用户详情类：

public class ApplicationUser implements Principal {
    private Long userId;
    private String displayName;

    // 需提供displayName的getter方法
    public String getDisplayName() {
        return displayName;
    }
}

public class ApplicationUserDetails extends ApplicationUser implements UserDetails {
    // 实现UserDetails接口的方法
}

后端代码可通过强转Authentication的Principal获取属性，但Thymeleaf模板中直接调用#authentication?.principal.getDisplayName()无法生效，希望在模板中直接获取该属性用于构建个人资料链接，且避免在每个控制器中手动传递数据（链接位于页面头部，全局复用）。

解决方案 #

核心问题是Thymeleaf默认将#authentication.principal识别为Object类型，无法直接调用自定义类的方法/属性，需在模板中显式强制类型转换：

方法1：模板内直接强转访问属性 #

使用完整类名对principal进行强转，直接访问属性（需确保属性有对应getter方法）：

<a th:href="|/users/${((com.yourpackage.ApplicationUser) #authentication?.principal).displayName}|">Profile</a>

替换com.yourpackage为ApplicationUser实际所在的包路径。

方法2：模板内强转后调用getter方法 #

也可直接调用getter方法，效果与访问属性一致：

<a th:href="|/users/${((com.yourpackage.ApplicationUser) #authentication?.principal).getDisplayName()}|">Profile</a>

注意事项 #

• 必须确保ApplicationUser类中为displayName提供公共getter方法，否则Thymeleaf无法访问该属性；
• 若项目引入thymeleaf-extras-springsecurity依赖（Spring Security与Thymeleaf集成包），上述写法依然适用，核心是解决类型转换问题。

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