Spring Boot启动报错：缺少HttpSecurity类型Bean求助

这个错误的核心原因是Spring Boot Actuator的安全自动配置类ManagementWebSecurityAutoConfiguration需要一个HttpSecurity类型的Bean，但当前上下文里没有正确注册该Bean，通常是自定义安全配置的写法不符合Spring Boot + Spring Security的最新规范导致的。

核心修复步骤 #

1. 修正自定义SecurityConfig的写法（废弃WebSecurityConfigurerAdapter，改用SecurityFilterChain Bean）

如果你的SecurityConfig是继承WebSecurityConfigurerAdapter实现的，这种方式在Spring Security 5.7+已经被废弃，且不会自动暴露HttpSecurity Bean供Actuator自动配置使用。改成以下标准写法：

@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        // 这里添加你的自定义安全规则
        http.authorizeHttpRequests(auth -> auth
                .requestMatchers("/public/**", "/actuator/health").permitAll()
                .anyRequest().authenticated()
            )
            .formLogin(form -> form.permitAll())
            .logout(logout -> logout.permitAll());
        
        return http.build();
    }
}

这种方式会自动将构建完成的HttpSecurity逻辑封装为Bean，供Actuator的自动配置类调用。

2. 检查pom依赖兼容性

确保spring-boot-starter-security和spring-boot-starter-actuator的版本与你的Spring Boot主版本完全一致，避免版本冲突：

<!-- 示例Spring Boot 3.x依赖，根据你的实际版本调整 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-security</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

3. 移除不必要的自动配置排除

检查你的application.properties或application.yml，确保没有排除Actuator的安全自动配置类：

# 移除类似这样的配置（如果存在）
# spring.autoconfigure.exclude=org.springframework.boot.actuate.autoconfigure.security.servlet.ManagementWebSecurityAutoConfiguration

4. 避免手动定义ManagementSecurityFilterChain

如果你之前手动创建了ManagementSecurityFilterChain Bean，建议删除它，让Actuator的自动配置类自行处理管理端点的安全规则，除非你有特殊的定制需求。若确实需要定制，确保方法参数中的HttpSecurity是正确注入的：

// 仅在特殊需求下使用，否则删除该Bean
@Bean
public SecurityFilterChain managementSecurityFilterChain(HttpSecurity http) throws Exception {
    http.requestMatchers(matchers -> matchers.antMatchers("/actuator/**"))
        .authorizeHttpRequests(auth -> auth.anyRequest().permitAll());
    return http.build();
}

验证步骤 #

修改完成后，清理项目编译缓存（执行mvn clean或Gradle的clean任务），重新启动应用，查看错误是否消失。

内容的提问来源于stack exchange，提问作者asus tuf