Grails 3升5后Spring Security插件邮箱登录失效问题求助

1. 清理冗余配置，确保配置生效 #

• 只保留application.groovy或application.yml中的一处grails.plugin.springsecurity.userLookup.usernamePropertyName = 'email'配置，避免两种配置文件的优先级冲突导致配置未正确加载。
• 确认用户实体类中email字段的属性名与配置完全一致，且数据库中该字段是唯一约束，避免多用户匹配的潜在问题。

2. 定位二次调用的触发源 #

loadUserByUsername被两次调用，大概率是额外的认证逻辑或过滤器导致：

• 检查是否自定义了AuthenticationProvider或UserDetailsService实现，排查代码中是否存在手动触发的二次用户查询逻辑。
• 查看项目的安全配置类，确认是否启用了remember-me、JWT等额外认证特性，这类功能可能在认证成功后再次调用用户查询方法。
• 检查是否存在多套认证过滤器链，导致认证流程被重复执行。

3. 修正UserDetailsService逻辑（若自定义） #

如果用了自定义的UserDetailsService，别硬编码查询字段：

• 动态读取配置的usernamePropertyName来构建查询，示例代码：

class CustomUserDetailsService implements UserDetailsService {
    def grailsApplication

    @Override
    UserDetails loadUserByUsername(String loginValue) throws UsernameNotFoundException {
        String lookupField = grailsApplication.config.grails.plugin.springsecurity.userLookup.usernamePropertyName
        User user = User.findBy(lookupField, loginValue)
        if (!user) {
            throw new UsernameNotFoundException("用户不存在：${loginValue}")
        }
        // 组装并返回UserDetails对象
    }
}

• 如果用的是默认GormUserDetailsService，不要覆盖其loadUserByUsername方法，默认实现会自动读取配置的查询字段。

4. 清理缓存并重启应用 #

Grails升级后可能残留配置缓存：

• 执行grails clean或./gradlew clean清理项目构建缓存。
• 完全重启应用，确保新配置被正确加载。

5. 核对登录表单的参数名 #

如果登录表单提交的参数名是email而非默认的username，需要补充配置：

grails.plugin.springsecurity.authentication.usernameParameter = 'email'

确保表单提交的邮箱值能正确传递到认证流程中。

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