Spring Boot 3集成Keycloak时Web安全配置失败求助

问题概述 #

在Spring Boot 3项目中配置Keycloak Web安全时，遇到两个核心问题：

• 报错com.c4_soft.springaddons.security.oauth2.config.SpringAddonsSecurityProperties$IssuerProperties.getLocation() 为null
• 出现通过方法setFilterChains表达的未满足依赖问题

相关代码与配置 #

初始WebSecurityConfig代码 #

@EnableMethodSecurity
public class WebSecurityConfig {
}

修改后的WebSecurityConfig代码 #

@EnableMethodSecurity(prePostEnabled = true)
public class WebSecurityConfig {

}

build.gradle配置 #

// spring
implementation(libs.spring.security.config)
// implementation(libs.spring.boot.starter.security)
implementation group: 'com.c4-soft.springaddons', name: 'spring-addons-webmvc-core', version: '6.0.9'
implementation group: 'com.c4-soft.springaddons', name: 'spring-addons-webmvc-jwt-resource-server', version: '6.0.9'

implementation(libs.spring.boot.starter.oauth2.client)
// implementation(libs.spring.security.oauth2.resource.server)

配置文件内容（application.properties） #

com.c4-soft.springaddons.security.issuers[0].location=http://localhost:8080/realms/master
com.c4-soft.springaddons.security.issuers[0].authorities.claims=realm_access.roles,resource_access.spring-addons-public.roles,resource_access.spring-addons-confidential.roles
com.c4-soft.springaddons.security.cors[0].path=/fa/**
com.c4-soft.springaddons.security.permit-all=/actuator/health/readiness,/actuator/health/liveness
#explore for more with your IDE auto completion with com.c4-soft.springaddons.security.

spring.security.oauth2.resourceserver.jwt.issuer-uri=http://localhost:8080/realms/master
spring.security.oauth2.resourceserver.jwt.jwk-set-uri=http://localhost:8080/realms/master/protocol/openid-connect/certs

解决方案 #

1. 修正WebSecurityConfig类的配置 #

当前配置类缺少@Configuration注解，且未继承spring-addons提供的适配器，导致Spring无法正确加载安全配置并初始化过滤器链。修改后的代码如下：

@Configuration
@EnableMethodSecurity(prePostEnabled = true)
public class WebSecurityConfig extends SpringAddonsWebSecurityConfigurerAdapter {
}

• @Configuration：标记该类为Spring配置类，确保被上下文扫描到
• 继承SpringAddonsWebSecurityConfigurerAdapter：复用spring-addons的预配置逻辑，自动处理JWT验证、过滤器链初始化等核心逻辑

2. 移除冲突的配置项 #

配置文件中同时存在spring-addons和原生Spring Security的OAuth2资源服务器配置，二者会产生冲突。删除原生配置部分：

# 移除以下两行配置
# spring.security.oauth2.resourceserver.jwt.issuer-uri=http://localhost:8080/realms/master
# spring.security.oauth2.resourceserver.jwt.jwk-set-uri=http://localhost:8080/realms/master/protocol/openid-connect/certs

3. 验证配置绑定有效性 #

虽然Spring Boot支持配置文件中中划线与Java类中下划线的自动转换，但仍需确保：

• 配置文件格式正确（当前为properties格式，无语法错误）
• com.c4-soft.springaddons.security.issuers[0].location配置项未被注释或拼写错误

4. 检查依赖完整性 #

确保项目已引入spring-boot-starter-web（WebMVC场景必备），若未添加，在build.gradle中补充：

implementation(libs.spring.boot.starter.web)

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