使用Spring Boot+OAuth2+JPA构建安全REST API时遇BCrypt警告及401错误

这个问题我之前也碰到过，核心原因就是密码没有用BCrypt正确加密存储，或者密码编码器的配置和实际存储的密码格式不匹配，导致Spring Security无法正确验证，进而抛出警告并返回401。下面一步步帮你解决：

1. 确保用户密码是BCrypt加密格式 #

BCrypt加密后的密码以$2a$/$2b$/$2y$开头，长度固定为60位左右。如果你的数据库里存的是明文user，肯定会触发这个警告。你可以用以下代码生成加密后的密码：

import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;

public class PasswordGenerator {
    public static void main(String[] args) {
        BCryptPasswordEncoder encoder = new BCryptPasswordEncoder();
        // 生成"user"的BCrypt加密密码，复制这个结果存到数据库
        System.out.println(encoder.encode("user"));
    }
}

把生成的加密字符串替换数据库中对应用户的password字段值。

2. 正确配置BCrypt密码编码器 #

在Spring Security配置类中，必须明确定义BCryptPasswordEncoder的Bean，并确保OAuth2配置正确引用它：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.authentication.AuthenticationManager;
import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.security.crypto.password.PasswordEncoder;

@Configuration
public class WebSecurityConfig extends WebSecurityConfigurerAdapter {

    @Autowired
    private UserDetailsService userDetailsService;

    // 定义BCrypt密码编码器Bean
    @Bean
    public PasswordEncoder passwordEncoder() {
        return new BCryptPasswordEncoder();
    }

    // 配置认证管理器，指定用户服务和密码编码器
    @Override
    @Bean
    public AuthenticationManager authenticationManagerBean() throws Exception {
        return super.authenticationManagerBean();
    }

    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
        auth.userDetailsService(userDetailsService)
            .passwordEncoder(passwordEncoder());
    }
}

3. 检查OAuth2客户端配置 #

如果你的OAuth2客户端信息是存在内存或数据库中，客户端的secret也需要用BCrypt加密（和用户密码一样）：

import org.springframework.context.annotation.Configuration;
import org.springframework.security.oauth2.config.annotation.configurers.ClientDetailsServiceConfigurer;
import org.springframework.security.oauth2.config.annotation.web.configuration.AuthorizationServerConfigurerAdapter;
import org.springframework.security.oauth2.config.annotation.web.configuration.EnableAuthorizationServer;

@Configuration
@EnableAuthorizationServer
public class AuthorizationServerConfig extends AuthorizationServerConfigurerAdapter {

    @Autowired
    private PasswordEncoder passwordEncoder;

    @Override
    public void configure(ClientDetailsServiceConfigurer clients) throws Exception {
        clients.inMemory()
                .withClient("your-client-id")
                // 客户端密钥必须用BCrypt加密
                .secret(passwordEncoder.encode("your-client-secret"))
                .authorizedGrantTypes("password", "refresh_token")
                .scopes("read", "write")
                .accessTokenValiditySeconds(3600);
    }
}

4. 修正Postman请求配置 #

你可能混淆了客户端认证信息和用户认证信息：

• Postman的Basic Auth需要填写的是OAuth2的client-id和client-secret（对应上面配置的your-client-id和your-client-secret）
• 用户的username=user和password=user是放在请求参数里的，不要填到Basic Auth中

5. 数据库字段检查 #

确保数据库中存储密码的字段长度足够（建议设为VARCHAR(100)），避免BCrypt加密后的60位密码被截断，导致验证失败。

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