Spring Boot OAuth2认证异常：正确用户名+错误密码引发Bean创建失败

我来帮你搞定这个头疼的问题！你遇到的这个空指针异常（NPE），核心原因是密码校验失败时，事务相关Bean的初始化流程被异常触发，导致依赖资源未就绪引发空指针。咱们一步步拆解分析，给出可行的解决方案：

问题复现场景 #

先明确你的当前表现，方便后续对照验证：

• 正确用户名+密码：正常返回令牌响应

  { 
    "access_token": "b8c45984-c573-4837-9ef6-6896f308a286", 
    "token_type": "bearer", 
    "refresh_token": "48145463-830e-4467-ab89-587bda6b32de", 
    "expires_in": 43199, 
    "scope": "read write" 
  }
  

• 错误用户名：正常返回错误响应

  {"error": "unauthorized", "error_description": "No value present"}
  

• 正确用户名+错误密码：抛出嵌套NPE的Bean创建异常

  2018-05-28 14:47:25.264 WARN 6604 --- [nio-8088-exec-2] .c.j.MappingJackson2HttpMessageConverter : Failed to evaluate Jackson serialization for type [class org.springframework.security.oauth2.provider.error.DefaultWebResponseExceptionTranslator$UnauthorizedException]: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'org.springframework.security.oauth2.common.exceptions.OAuth2ExceptionJackson2Serializer': BeanPostProcessor before instantiation of bean failed; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'org.springframework.transaction.config.internalTransactionAdvisor' defined in class path resource [org/springframework/transaction/annotation/ProxyTransactionManagementConfiguration.class]: Bean instantiation via factory method failed; nested exception is org.springframework.beans.BeanInstantiationException: Failed to instantiate [org.springframework.transaction.interceptor.BeanFactoryTransactionAttributeSourceAdvisor]: Factory method 'transactionAdvisor' threw exception; nested exception is java.lang.NullPointerException
  

核心原因拆解 #

当密码校验失败抛出BadCredentialsException时，默认的DefaultWebResponseExceptionTranslator会尝试序列化OAuth2异常，但这个过程意外触发了事务切面Bean（internalTransactionAdvisor）的初始化流程。此时事务管理器依赖的核心资源（比如数据源）可能还未完全初始化，或者你的事务配置存在缺失，最终导致空指针异常。

针对性解决方案 #

1. 检查并修复基础事务配置 #

首先确保事务相关的依赖和配置都到位：

• 确认项目引入了事务依赖（Maven示例）：

  <!-- 基础事务依赖 -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-transaction</artifactId>
  </dependency>
  <!-- 如果用JPA做用户数据存储，还需引入 -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
  

• 检查配置类是否添加了@EnableTransactionManagement注解，同时确认application.yml/application.properties中的数据源配置（url、用户名、密码）完全正确。

2. 自定义异常转换器，提前拦截密码错误 #

通过自定义WebResponseExceptionTranslator，直接处理BadCredentialsException，避免触发后续可能出问题的Bean初始化流程：

import org.springframework.security.authentication.BadCredentialsException;
import org.springframework.security.oauth2.common.exceptions.OAuth2Exception;
import org.springframework.security.oauth2.provider.error.DefaultWebResponseExceptionTranslator;
import org.springframework.security.oauth2.provider.error.WebResponseExceptionTranslator;
import org.springframework.stereotype.Component;
import org.springframework.http.ResponseEntity;

@Component
public class CustomOAuth2ExceptionTranslator implements WebResponseExceptionTranslator<OAuth2Exception> {

    @Override
    public ResponseEntity<OAuth2Exception> translate(Exception e) throws Exception {
        // 直接拦截密码错误异常，返回标准OAuth2错误响应
        if (e instanceof BadCredentialsException) {
            OAuth2Exception oAuth2Exception = new OAuth2Exception("Invalid credentials", e);
            return ResponseEntity
                    .status(org.springframework.http.HttpStatus.UNAUTHORIZED)
                    .body(oAuth2Exception);
        }
        // 其他异常交给默认转换器处理
        DefaultWebResponseExceptionTranslator defaultTranslator = new DefaultWebResponseExceptionTranslator();
        return defaultTranslator.translate(e);
    }
}

然后在授权服务器配置中注入这个自定义转换器：

@Configuration
@EnableAuthorizationServer
public class AuthorizationServerConfig extends AuthorizationServerConfigurerAdapter {

    private final CustomOAuth2ExceptionTranslator exceptionTranslator;

    // 构造注入自定义转换器
    public AuthorizationServerConfig(CustomOAuth2ExceptionTranslator exceptionTranslator) {
        this.exceptionTranslator = exceptionTranslator;
    }

    @Override
    public void configure(AuthorizationServerEndpointsConfigurer endpoints) throws Exception {
        // 替换默认异常转换器
        endpoints.exceptionTranslator(exceptionTranslator);
        // 其他原有配置：tokenStore、authenticationManager等
    }
}

3. 确认密码编码器配置正确 #

确保你配置了合法的PasswordEncoder，并且数据库中存储的用户密码是用该编码器加密后的结果：

@Bean
public PasswordEncoder passwordEncoder() {
    // 推荐使用BCrypt强哈希编码器
    return new BCryptPasswordEncoder();
}

同时要保证UserDetailsService或AuthenticationManager正确注入了这个编码器，避免密码校验时出现隐性异常。

验证效果 #

修改完成后，再次测试「正确用户名+错误密码」的场景，应该会返回和「错误用户名」一致的标准错误响应，不再抛出NPE异常。

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