Spring Boot + Vaadin 用户登录认证失败问题求助

针对你遇到的登录失败且loadUserByUsername未被调用的问题，按以下方向逐一排查：

1. 核对Spring Security核心配置 #

• 确认SecurityConfig类上标注了@Configuration和@EnableWebSecurity注解，确保配置类被Spring加载
• 检查UserDetailsService的Bean注册：要么在UserService类上加@Service注解，要么在SecurityConfig中通过@Bean显式声明，同时确保没有其他UserDetailsService的Bean存在（避免Spring注入错误实例）
• 验证过滤器链配置：确保登录端点（默认/login）没有被拦截，同时正确放行Vaadin的静态资源（比如/VAADIN/**、/frontend/**等），示例配置参考：

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
      http
          .authorizeHttpRequests(auth -> auth
              .requestMatchers("/register", "/VAADIN/**", "/frontend/**").permitAll()
              .anyRequest().authenticated()
          )
          .formLogin(form -> form
              .loginPage("/login")
              .permitAll()
          );
      return http.build();
  }
  

• 确认配置了正确的密码编码器，且注册和登录使用同一实例：

  @Bean
  public PasswordEncoder passwordEncoder() {
      return new BCryptPasswordEncoder();
  }
  

2. 检查Vaadin LoginView的表单配置 #

• 确保登录表单的action属性与Spring Security配置的登录处理URL一致（默认是/login），如果使用Vaadin的LoginForm组件，需确认提交逻辑没有自定义拦截，示例正确用法：

  LoginForm loginForm = new LoginForm();
  loginForm.setAction("login"); // 与Security配置的登录端点匹配
  add(loginForm);
  

• 确认表单的用户名、密码字段name属性为username和password（Spring Security默认参数名），如果自定义了参数名，需在SecurityConfig中配置：

  .formLogin(form -> form
      .usernameParameter("email") // 若用邮箱作为用户名，需指定参数名
      .passwordParameter("password")
  )
  

3. 验证UserService的实现正确性 #

• 确认UserService正确实现UserDetailsService接口，且重写方法签名无误（注意参数是String username，不要误写为loadUserByEmail），示例：

  @Service
  public class UserService implements UserDetailsService {
      @Override
      public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
          // 从数据库查询用户逻辑
          User user = userRepository.findByEmail(username)
              .orElseThrow(() -> new UsernameNotFoundException("User not found"));
          return User.withUsername(user.getEmail())
              .password(user.getPassword())
              .roles(user.getRole())
              .build();
      }
  }
  

• 检查UserService所在包是否在Spring Boot的组件扫描范围内（默认是启动类所在包及其子包）

4. 开启调试日志追踪流程 #

在application.properties中添加日志配置，查看Spring Security的认证细节：

logging.level.org.springframework.security=DEBUG

重点关注：

• 登录请求是否到达Spring Security过滤器
• 是否有UserDetailsService调用的日志记录
• 是否存在认证失败的具体原因（比如参数不匹配、用户未找到等）

5. 数据库数据一致性验证 #

• 确认登录输入的邮箱与数据库存储的完全一致（注意MySQL字符集是否区分大小写）
• 手动验证密码匹配：用BCryptPasswordEncoder的matches方法，对比输入密码和数据库中的加密串是否匹配，示例：

BCryptPasswordEncoder encoder = new BCryptPasswordEncoder();
boolean isMatch = encoder.matches("输入的密码", "数据库中的加密串");
System.out.println(isMatch); // 若为false，说明注册时加密逻辑有问题

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