Spring Security测试问题：.getPrincipal()在应用与测试中返回对象不一致

核心问题根源 #

你遇到的ClassCastException本质是运行时与测试环境中Authentication.getPrincipal()的返回类型不一致：

• 运行时你的认证逻辑可能将Principal设置为了用户名字符串，但测试时@WithMockUser默认创建的是UserDetails实例（具体是org.springframework.security.core.userdetails.User），直接强转String必然报错。
• 不管是@WithUserDetails还是自定义注解，只要你的代码依然把Principal强转为String，就会触发同样的异常——因为这些注解都是创建UserDetails实现类作为Principal，而非纯字符串。

直接修复方案 #

修改CommentService.save()方法中获取用户名的逻辑，兼容Principal的两种类型（UserDetails或String）：

@Override
public Comment save(CommentDto commentDto) {
    Object principal = SecurityContextHolder.getContext().getAuthentication().getPrincipal();
    // 统一处理Principal，提取用户名
    String username;
    if (principal instanceof UserDetails) {
        username = ((UserDetails) principal).getUsername();
    } else {
        username = principal.toString();
    }

    Optional<User> userOptional = userRepository.findUserByUsername(username);
    // 后续逻辑保持不变...
}

这样修改后，无论是运行时的字符串Principal，还是测试时的UserDetails实例，都能正确提取用户名，同时兼容两种场景。

为什么之前的尝试无效？ #

1. @WithUserDetails：该注解会调用你的UserDetailsService从数据库加载真实用户，返回的Principal是你的CustomUserDetails实例，强转String依然会报错。
2. 自定义@WithMockCustomUser：如果你的WithMockCustomUserSecurityContextFactory中依然创建CustomUserDetails作为Principal，那强转String的逻辑本身就错误——你需要的是从Principal中提取用户名，而非把Principal本身当作用户名。

额外优化建议 #

可以封装一个工具方法，统一处理当前登录用户的用户名获取，避免重复代码：

public class SecurityUtils {
    public static String getCurrentUsername() {
        Object principal = SecurityContextHolder.getContext().getAuthentication().getPrincipal();
        if (principal instanceof UserDetails) {
            return ((UserDetails) principal).getUsername();
        }
        return principal.toString();
    }
}

之后在Service中直接调用：

String username = SecurityUtils.getCurrentUsername();
Optional<User> userOptional = userRepository.findUserByUsername(username);

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