解决：No AuthenticationProvider found for org.springframework.security.authentication.UsernamePasswordA
解决：No AuthenticationProvider found for org.springframework.security.authentication.UsernamePasswordA
默 语
发布于 2025-05-21 15:32:34
发布于 2025-05-21 15:32:34
解决：No AuthenticationProvider found for org.springframework.security.authentication.UsernamePasswordAuthenticationToken
摘要
在开发基于 Spring Security 的 Java 项目时，遇到 No AuthenticationProvider found for org.springframework.security.authentication.UsernamePasswordAuthenticationToken 错误，是许多开发者常见的问题。本文将为你详细分析该问题的原因，并提供一个简单易懂的解决方法，附带完整代码示例和最佳实践建议，助你快速解决该问题。
引言
Spring Security 是一个功能强大的安全框架，用于处理身份验证和授权。但它的高度灵活性，也意味着配置的复杂性。
当你使用 UsernamePasswordAuthenticationToken 作为登录的认证令牌时，如果未正确配置 AuthenticationProvider，Spring Security 将无法验证用户，从而抛出 No AuthenticationProvider found 异常。
以下是问题出现的典型场景：
- 项目中引入了自定义的登录逻辑。
- 配置类未定义支持
UsernamePasswordAuthenticationToken的认证提供器。
接下来，让我们一步步了解问题的根本原因和解决方法。
正文
1. 问题复现
当你在 Spring Security 项目中编写自定义的登录认证逻辑时，比如：
Authentication authentication = authenticationManager.authenticate(
new UsernamePasswordAuthenticationToken(username, password)
);运行时，抛出以下异常：
No AuthenticationProvider found for org.springframework.security.authentication.UsernamePasswordAuthenticationToken原因：
Spring Security 的认证流程需要 AuthenticationProvider 对象处理特定类型的 Authentication，但项目中未正确注册支持 UsernamePasswordAuthenticationToken 的 AuthenticationProvider。
2. 解决方法
我们可以通过以下步骤解决这个问题：
2.1 自定义 AuthenticationProvider
实现一个自定义的 AuthenticationProvider，专门处理 UsernamePasswordAuthenticationToken。
import org.springframework.security.authentication.AuthenticationProvider;
import org.springframework.security.authentication.UsernamePasswordAuthenticationToken;
import org.springframework.security.core.Authentication;
import org.springframework.security.core.AuthenticationException;
import org.springframework.security.core.userdetails.User;
import org.springframework.security.core.userdetails.UserDetails;
import org.springframework.security.crypto.password.PasswordEncoder;
import java.util.Collections;
public class CustomAuthenticationProvider implements AuthenticationProvider {
private final PasswordEncoder passwordEncoder;
public CustomAuthenticationProvider(PasswordEncoder passwordEncoder) {
this.passwordEncoder = passwordEncoder;
}
@Override
public Authentication authenticate(Authentication authentication) throws AuthenticationException {
String username = authentication.getName();
String password = authentication.getCredentials().toString();
// 模拟从数据库中查询用户
UserDetails user = User.builder()
.username("test_user")
.password(passwordEncoder.encode("test_password"))
.roles("USER")
.build();
if (passwordEncoder.matches(password, user.getPassword())) {
return new UsernamePasswordAuthenticationToken(username, password, user.getAuthorities());
} else {
throw new RuntimeException("Authentication failed");
}
}
@Override
public boolean supports(Class<?> authentication) {
return UsernamePasswordAuthenticationToken.class.isAssignableFrom(authentication);
}
}2.2 配置 CustomAuthenticationProvider
将自定义的 AuthenticationProvider 注入到 Spring Security 的上下文中：
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.authentication.AuthenticationManager;
import org.springframework.security.authentication.AuthenticationProvider;
import org.springframework.security.config.annotation.authentication.configuration.AuthenticationConfiguration;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.security.crypto.password.PasswordEncoder;
@Configuration
public class SecurityConfig {
@Bean
public AuthenticationProvider authenticationProvider(PasswordEncoder passwordEncoder) {
return new CustomAuthenticationProvider(passwordEncoder);
}
@Bean
public PasswordEncoder passwordEncoder() {
return new BCryptPasswordEncoder();
}
@Bean
public AuthenticationManager authenticationManager(AuthenticationConfiguration configuration) throws Exception {
return configuration.getAuthenticationManager();
}
}3. 测试解决方案
创建一个简单的 REST 接口，验证登录是否正常工作：
import org.springframework.security.authentication.AuthenticationManager;
import org.springframework.security.authentication.UsernamePasswordAuthenticationToken;
import org.springframework.security.core.Authentication;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/auth")
public class AuthController {
private final AuthenticationManager authenticationManager;
public AuthController(AuthenticationManager authenticationManager) {
this.authenticationManager = authenticationManager;
}
@PostMapping("/login")
public String login(@RequestBody LoginRequest request) {
Authentication authentication = authenticationManager.authenticate(
new UsernamePasswordAuthenticationToken(request.getUsername(), request.getPassword())
);
return "Login successful for user: " + authentication.getName();
}
}
class LoginRequest {
private String username;
private String password;
// Getters and setters...
}测试接口：
- 请求示例：
POST /auth/login
Content-Type: application/json
{
"username": "test_user",
"password": "test_password"
}- 响应示例：
Login successful for user: test_user总结
通过自定义 AuthenticationProvider 并注册到 Spring Security 上下文中，可以有效解决 No AuthenticationProvider found 问题。
核心步骤总结：
- 自定义 AuthenticationProvider：实现
supports和authenticate方法。 - 配置类注册 Provider：确保 Spring Security 知道如何使用该提供器。
- 测试与验证：确认登录流程是否正确处理了用户认证。
参考资料
本文参与 腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。
原始发表：2024-12-09，如有侵权请联系 cloudcommunity@tencent.com 删除
评论
登录后参与评论
推荐阅读
目录
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号