Spring Boot配置自定义账号密码后Basic Authentication登录失败

问题分析 #

在Spring Boot 2.7.4项目中配置spring.security.user.name和spring.security.user.password后无法登录，常见原因包括：

• 密码未加密：Spring Boot 2.x及后续版本默认要求密码为加密格式，明文密码会被安全机制拒绝
• 配置项含多余空格：配置文件中用户名/密码末尾的空格会被识别为内容的一部分，导致输入不匹配
• 自定义Security配置类覆盖默认逻辑：如果编写了WebSecurityConfigurerAdapter子类，可能覆盖了默认的用户配置加载逻辑

解决方案 #

1. 检查配置文件空格 #

打开application.properties，确保配置项末尾无多余空格，修正后应为：

spring.security.user.name=user
spring.security.user.password=password

2. 处理密码加密问题 #

方式一：使用BCrypt加密密码（推荐生产环境）

生成BCrypt加密后的密码替换到配置文件：

• 编写工具类生成加密密码：

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

public class PasswordGenerator {
    public static void main(String[] args) {
        BCryptPasswordEncoder encoder = new BCryptPasswordEncoder();
        // 替换为你的明文密码
        System.out.println(encoder.encode("password"));
    }
}

• 将控制台输出的加密字符串配置到文件：

spring.security.user.name=user
spring.security.user.password={bcrypt}$2a$10$xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

方式二：临时允许明文密码（仅开发环境）

在密码前添加noop:前缀，告知Spring Security使用明文验证：

spring.security.user.name=user
spring.security.user.password=noop:password

3. 检查自定义Security配置类 #

如果项目存在自定义WebSecurityConfigurerAdapter子类：

• 若无需自定义用户逻辑，直接删除该类，Spring Boot会自动加载配置文件中的用户信息
• 若需保留配置类，确保未重写userDetailsService方法，或在方法中兼容加载配置文件的用户信息

额外优化：清理pom.xml重复依赖 #

你的pom.xml重复引入了springfox-swagger2和springfox-swagger-ui依赖，建议删除重复项避免潜在冲突：

<!-- 删除以下重复依赖 -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.7.0</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.7.0</version>
</dependency>

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