Spring Security配置POST请求返回401未授权及角色找不到问题

问题描述 #

调用POST接口/auth/register时，Postman返回401 Unauthorized错误；同时IntelliJ抛出RuntimeException: Role not found，但数据库中已存在ADMIN和USER角色。

相关代码 #

注册接口代码 #

@PostMapping("/register")
public ResponseEntity<String> register(@RequestBody RegisterDto registerDto) {
    if (userRespository.existsByUsername(registerDto.getUsername())) {
        return ResponseEntity.badRequest().body("Username is taken");
    }
    UserEntity user = new UserEntity();
    user.setUsername(registerDto.getUsername());
    user.setPassword(passwordEncoder.encode(registerDto.getPassword()));

    Role role = roleRepository.findByName("ADMIN").orElseThrow(() -> new RuntimeException("Role not found"));
    user.setRoles(Collections.singletonList(role));  
    userRespository.save(user);

    return ResponseEntity.ok().body("User registered successfully");
}

Security配置代码 #

@Bean
public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
    http
            .csrf(csrf -> csrf.disable())
            .authorizeHttpRequests(authorize -> authorize
                    .requestMatchers("/auth/**").permitAll()
                    .anyRequest().authenticated()
            )
            .httpBasic();
    return http.build();
}

实体类代码 #

@Table(name = "users")
public class UserEntity {
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private int id;
    private String username;
    private String password;

    @ManyToMany(fetch = FetchType.EAGER,cascade = CascadeType.ALL)
    @JoinTable(name = "user_role",joinColumns = @JoinColumn(name = "user_id",referencedColumnName = "id"),
                inverseJoinColumns = @JoinColumn(name = "role_id",referencedColumnName = "id"))
    private List<Role> roles=new ArrayList<>();
}

public class Role {
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private int id;
    private String name;
}

依赖配置 #

<parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.2.5</version>
        <relativePath/> <!-- lookup parent from repository -->
</parent>
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-security</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.security</groupId>
        <artifactId>spring-security-test</artifactId>
        <scope>test</scope>
    </dependency>

</dependencies>

问题排查与解决方案 #

一、解决"Role not found"异常 #

1. 检查角色名称大小写匹配
   数据库中存储的角色名称可能是小写（如admin），但代码中查询的是大写"ADMIN"，导致匹配失败。可以：

   • 统一数据库和代码中的角色名称大小写；
   • 修改查询方法为忽略大小写，在RoleRepository中定义：

     Optional<Role> findByNameIgnoreCase(String name);
     

     然后在注册接口中调用roleRepository.findByNameIgnoreCase("ADMIN")。

2. 验证Role实体的字段映射
   Role类的name字段未添加@Column注解，若数据库表中字段名与实体属性名不一致（比如数据库字段是role_name），会导致查询失败。添加注解明确映射：

   @Column(name = "name") // 匹配数据库实际字段名
   private String name;
   

3. 确认RoleRepository的方法定义
   确保RoleRepository正确继承JpaRepository，且findByName方法符合JPA查询规范：

   public interface RoleRepository extends JpaRepository<Role, Integer> {
       Optional<Role> findByName(String name);
   }
   

二、解决401 Unauthorized错误 #

1. 添加PasswordEncoder Bean
   注册接口中使用了passwordEncoder，但Security配置中未定义该Bean，会导致Spring Security无法处理密码编码，进而触发认证拦截。添加以下Bean：

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

2. 验证请求路径匹配
   确认请求路径是否完全匹配/auth/register，比如是否存在上下文路径（如/api/auth/register），导致requestMatchers("/auth/**")未匹配到实际请求。可打印请求日志或调整路径规则：

   .requestMatchers("/auth/**", "/api/auth/**").permitAll()
   

3. 排查其他拦截器/过滤器
   若项目中存在自定义过滤器，可能提前拦截了/auth/**路径的请求，需检查过滤器的执行顺序和拦截规则，确保注册接口被放行。

内容的提问来源于stack exchange，提问作者Kadir Özer Öztürk