<think>我们正在解决
Spring Boot项目中`
spring-boot-starter
-security`与`
spring-security-config`包之间的冲突问题。
冲突通常是由于版本不匹配引起的。`
spring-boot-starter
-security`是一个starter，它会
引入一系列
Spring Security相关的依赖，包括`
spring-security-config`。如果我们单独
引入`
spring-security-config`且版本与starter中管理的版本不一致，就会导致冲突。
解决步骤：
1. **确认冲突**：使用Maven或Gradle的依赖树命令查看冲突。
2. **统一版本**：由于
Spring Boot通过`
spring-boot-starter
-parent`管理依赖版本，推荐使用
Spring Boot的依赖管理，避免手动指定版本。
3. **排除冲突**：如果确实需要
引入其他版本的`
spring-security-config`，可以在依赖中排除starter中的版本，然后
引入指定版本（但需谨慎，确保兼容性）。
具体操作：
**Maven项目**：
步骤1：查看依赖树，找到冲突
```
mvn dependency:tree
```
步骤2：在`
spring-boot-starter
-security`中排除`
spring-security-config`（如果确实需要
引入不同的版本，一般不推荐）
```xml
<dependency>
<groupId>org.
springframework.
boot</groupId>
<artifactId>
spring-boot-starter
-security</artifactId>
<exclusions>
<exclusion>
<groupId>org.
springframework.
security</groupId>
<artifactId>
spring-security-config</artifactId>
</exclusion>
</exclusions>
</dependency>
```
步骤3：然后单独
引入你需要的`
spring-security-config`版本（注意与
Spring Boot版本的兼容性）
```xml
<dependency>
<groupId>org.
springframework.
security</groupId>
<artifactId>
spring-security-config</artifactId>
<version>6.5.6</version> <!
-- 确保此版本与
Spring Boot管理的其他
Spring Security组件兼容
-->
</dependency>
```
**Gradle项目**：
步骤1：查看依赖树
```
gradle dependencies
```
步骤2：排除依赖并
引入指定版本
```gradle
implementation('org.
springframework.
boot:
spring-boot-starter
-security') {
exclude group: 'org.
springframework.
security', module: '
spring-security-config'
}
implementation 'org.
springframework.
security:
spring-security-config:6.5.6'
```
**重要建议**：
1. **优先使用
Spring Boot管理的版本**：
Spring Boot的starter已经管理了
Spring Security组件的版本，通常不需要单独
引入`
spring-security-config`。如果你需要特定功能，应该升级
Spring Boot版本，因为
Spring Boot会升级其管理的
Spring Security版本。
2. **检查兼容性**：如果你必须使用不同版本的`
spring-security-config`，请确保该版本与
Spring Boot版本兼容。参考[
Spring Boot官方文档](https://docs.
spring.io/
spring-boot/docs/current/reference/html/dependency
-versions.html)中的版本对应关系。
3. **避免手动指定**：在绝大多数情况下，只需
引入`
spring-boot-starter
-security`即可，它会自动
引入正确版本的`
spring-security-config`。
引用中提到
Spring Security的配置（引用[1]
和[4]）以及版本管理（引用[3]），所以解决冲突的关键在于依赖管理。另外，引用[3]提到
Spring Boot 2.0后
默认使用Lettuce，这暗示了版本兼容性的重要性。
如果你在项目中同时
引入了这两个依赖，且没有版本冲突，其实不需要排除。只有当出现版本不一致导致问题时，才需要按照上述步骤解决。
关于
Spring Boot与
Spring Security的版本对应关系，可参考以下表格（部分）：
|
Spring Boot版本 |
Spring Security版本 |
|
----------------|
---------------------|
| 3.2.x | 6.2.x |
| 3.1.x | 6.1.x |
| 3.0.x | 6.0.x |
| 2.7.x | 5.7.x |
| 2.6.x | 5.6.x |
对于6.5.6版本的`
spring-security-config`，它需要
Spring Boot 3.2.0及以上版本。因此，请确保你的
Spring Boot版本与之匹配。
例如，使用
Spring Boot 3.2.0，则
默认的
Spring Security版本是6.2.0。如果你想使用6.5.6，可以在Maven中覆盖版本属性：
```xml
<properties>
<
spring-security.version>6.5.6</
spring-security.version>
</properties>
```
这样，所有
Spring Security相关的依赖（包括`
spring-security-config`）都会升级到6.5.6，而
Spring Boot的其他依赖保持不变。这种方式比排除更安全，因为保持了所有
Spring Security模块版本一致。
总结：解决冲突的最佳实践是让
Spring Boot统一管理版本，不要单独
引入`
spring-security-config`。如果必须
引入，则排除starter中的版本并确保新版本兼容。
相关问题：
1. 如何查看
Spring Boot与
Spring Security的版本对应关系？
2. 在Maven中如何统一管理
Spring Security的版本？
3. 排除依赖后出现ClassNotFoundError如何解决？
4.
Spring Boot项目中如何升级
Spring Security到指定版本？
5. 如何解决多个
Spring Security模块版本不一致的问题？
</think>### 解决
Spring Boot Security 依赖冲突的方法
当 `
spring-boot-starter
-security` 与 `
spring-security-config` 发生版本冲突时，可通过以下步骤解决：
---
### 一、冲突原因分析
1. **版本不匹配**：`
spring-boot-starter
-security` 已包含 `
spring-security-config`（如
Spring Boot 3.2.x
默认集成
Security 6.2.x），手动添加不同版本的 `
spring-security-config` 会导致冲突[^1]
2. **隐性依赖**：其他依赖可能间接
引入不同版本的
Security 组件
3. **配置重叠**：两个依赖提供的安全配置类可能重复加载
---
### 二、解决方案（Maven项目示例）
#### 方法1：统一依赖版本（推荐）
在 `pom.xml` 中仅保留 starter 依赖，移除手动添加的 config 依赖：
```xml
<dependency>
<groupId>org.
springframework.
boot</groupId>
<artifactId>
spring-boot-starter
-security</artifactId>
</dependency>
<!
-- 移除以下手动添加的依赖
-->
<!
-- <dependency>
<groupId>org.
springframework.
security</groupId>
<artifactId>
spring-security-config</artifactId>
<version>xxx</version>
</dependency>
-->
```
#### 方法2：版本对齐
若需指定
Security 版本，通过属性统一管理：
```xml
<properties>
<
spring-security.version>6.5.6</
spring-security.version>
</properties>
<dependency>
<groupId>org.
springframework.
boot</groupId>
<artifactId>
spring-boot-starter
-security</artifactId>
</dependency>
<!
-- 无需单独声明 config
-->
```
#### 方法3：依赖排除
当其他组件
引入冲突版本时：
```xml
<dependency>
<groupId>problematic.group</groupId>
<artifactId>problematic
-artifact</artifactId>
<exclusions>
<exclusion>
<groupId>org.
springframework.
security</groupId>
<artifactId>
spring-security-config</artifactId>
</exclusion>
</exclusions>
</dependency>
```
---
### 三、验证解决方案
1. **检查依赖树**：
```bash
mvn dependency:tree
-Dincludes=org.
springframework.
security
```
输出应显示唯一版本：
```
[INFO] +
- org.
springframework.
boot:
spring-boot-starter
-security:jar:3.2.0
[INFO] | \
- org.
springframework.
security:
spring-security-config:jar:6.2.0
```
2. **运行时验证**：
```
java
// 在启动类中检查版本
@
SpringBootApplication
public class App {
public static void main(String[] args) {
System.out.println("
Security Config版本: " +
Http
Security.class.getPackage().getImplementationVersion());
SpringApplication.run(App.class, args);
}
}
```
---
### 四、Gradle解决方案
在 `build.gradle` 中统一版本：
```gradle
ext {
set('
springSecurityVersion', '6.5.6')
}
dependencies {
implementation 'org.
springframework.
boot:
spring-boot-starter
-security'
// 不需要单独
引入 config
}
// 强制所有模块使用统一版本
configurations.all {
resolutionStrategy.eachDependency { details
->
if (details.requested.group == 'org.
springframework.
security') {
details.useVersion "${
springSecurityVersion}"
}
}
}
```
---
### 五、最佳实践
1. **避免混合配置**：不要同时使用 `@EnableWeb
Security`
和 XML 配置
2. **优先使用 starter**：
Spring Boot Starter 已优化依赖管理（引用[1]）
3. **兼容性检查**：通过 [
Spring Boot 版本矩阵](https://
spring.io/projects/
spring-boot#support) 验证版本兼容性
4. **CSRF集成**：冲突解决后，
默认 CSRF 保护会自动生效（引用[4]）
> 经过上述处理，
Security 配置类如 `Http
Security` 将正常加载，参考[^1]实现定制化安全配置
---
### 相关问题
1. 如何查看
Spring Boot Starter 的隐性依赖树？
2. 多模块项目中如何统一管理
Spring Security 版本？
3.
Spring Security 6.x 与
Spring Boot 3.x 的兼容性要求有哪些？
4. 依赖冲突导致 CSRF 保护失效时如何排查？
5. 除了 Maven/Gradle，还有哪些工具可以解决 Jar 包冲突？
本文指导如何在Spring Boot应用中引入security starter，配置默认登录路径并演示了默认用户和密码认证过程。
扫一扫
2587
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
