Grails OAuth2与Spring Security Core：Principal异常问题

我之前也碰到过类似的问题，核心原因是Spring Security OAuth2默认生成的Principal对象和常规登录时的自定义UserDetails不是同一个类型——OAuth2登录默认返回的是DefaultOAuth2User或者OAuth2User，而你常规登录用的应该是自己实现的UserDetails子类，这就导致视图里依赖用户属性的代码找不到对应字段，进而渲染异常。

下面是具体的解决步骤：

1. 自定义OAuth2UserService，转换用户信息为自定义UserDetails #

你需要写一个自定义的OAuth2用户服务，把谷歌返回的OAuth2用户信息转换成你系统里的UserDetails实现类。比如：

import org.springframework.security.oauth2.client.userinfo.DefaultOAuth2UserService
import org.springframework.security.oauth2.client.userinfo.OAuth2UserRequest
import org.springframework.security.oauth2.core.OAuth2AuthenticationException
import org.springframework.security.oauth2.core.user.OAuth2User

class CustomOAuth2UserService extends DefaultOAuth2UserService {

    @Autowired
    UserService userService // 假设你有处理用户创建/查询的业务服务

    @Override
    OAuth2User loadUser(OAuth2UserRequest userRequest) throws OAuth2AuthenticationException {
        // 先获取OAuth2默认的用户信息
        OAuth2User oAuth2User = super.loadUser(userRequest)
        String registrationId = userRequest.clientRegistration.registrationId

        // 从谷歌返回的信息里提取关键字段（根据谷歌OAuth2的响应结构）
        String email = oAuth2User.getAttribute("email")
        String fullName = oAuth2User.getAttribute("name")
        String avatarUrl = oAuth2User.getAttribute("picture")

        // 在本地系统中查找或创建用户
        User localUser = userService.findOrCreateByEmail(email, fullName, avatarUrl)

        // 返回你的自定义UserDetails实现类，比如CustomUserDetails
        return new CustomUserDetails(localUser)
    }
}

2. 在Security配置中指定自定义的OAuth2UserService #

修改你的Spring Security配置类，让OAuth2登录使用上面的自定义服务：

import org.springframework.context.annotation.Configuration
import org.springframework.security.config.annotation.web.builders.HttpSecurity
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter

@Configuration
@EnableWebSecurity
class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Autowired
    CustomOAuth2UserService customOAuth2UserService

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                .antMatchers("/", "/login/**").permitAll()
                .anyRequest().authenticated()
                .and()
            .oauth2Login()
                .userInfoEndpoint()
                    .userService(customOAuth2UserService) // 绑定自定义用户服务
                .and()
            // 可选：自定义登录成功后的跳转逻辑
            .successHandler((request, response, authentication) -> {
                // 此时authentication.getPrincipal()就是你的CustomUserDetails
                SecurityContextHolder.context.authentication = authentication
                response.sendRedirect("/dashboard") // 跳转到你的主页
            })
    }
}

3. 确保CustomUserDetails实现UserDetails接口 #

你的自定义UserDetails类要实现Spring Security的UserDetails接口，包含系统所需的用户属性，比如：

import org.springframework.security.core.GrantedAuthority
import org.springframework.security.core.userdetails.UserDetails
import org.springframework.security.core.authority.SimpleGrantedAuthority

class CustomUserDetails implements UserDetails {

    private final User user

    CustomUserDetails(User user) {
        this.user = user
    }

    // 实现UserDetails的必要方法
    @Override
    Collection<? extends GrantedAuthority> getAuthorities() {
        // 返回用户的权限列表，比如从user.roles转换
        user.roles.collect { new SimpleGrantedAuthority(it.authority) }
    }

    @Override
    String getPassword() {
        user.password // OAuth2登录可能用不到，但接口必须实现
    }

    @Override
    String getUsername() {
        user.username ?: user.email
    }

    // 其他接口方法根据你的需求实现，比如isAccountNonExpired等
    @Override
    boolean isAccountNonExpired() { true }

    @Override
    boolean isAccountNonLocked() { true }

    @Override
    boolean isCredentialsNonExpired() { true }

    @Override
    boolean isEnabled() { user.enabled }

    // 自定义方法，方便视图获取用户属性
    String getFullName() {
        user.fullName
    }

    String getAvatarUrl() {
        user.avatarUrl
    }
}

关键注意点 #

• 视图中获取用户信息时，尽量通过UserDetails的接口方法或自定义getter，避免直接强转类型，比如用${currentUser.fullName}而不是${(User)currentUser.fullName}
• 确保UserService的findOrCreateByEmail方法正确处理新用户的创建逻辑（比如设置默认权限、密码等）

这样处理后，OAuth2登录成功后，SecurityContextHolder.context.authentication.principal就会是你的CustomUserDetails对象，和常规登录的Principal类型一致，视图渲染就不会再出问题了。

内容的提问来源于stack exchange，提问作者Filip Boroš