Spring 5迁移至Spring 6时spring-security-oauth2 SDK使用问题

核心问题原因 #

Spring 6全面切换到Jakarta EE命名空间（jakarta.*），而旧版spring-security-oauth2:2.x系列依赖完全基于Java EE的javax.*命名空间，两者无法兼容，直接引入会导致类路径冲突、编译错误。

可行解决方案 #

方案1：迁移到Spring Security官方替代模块 #

Spring官方已弃用spring-security-oauth2 2.x，推荐使用Spring Security OAuth 2.0 Authorization Server和Spring Security OAuth2 Client模块，这两个模块完全适配Jakarta命名空间，支持Spring 6：

• 移除旧依赖：

  <dependency>
      <groupId>org.springframework.security</groupId>
      <artifactId>spring-security-oauth2</artifactId>
      <version>2.5.2</version>
  </dependency>
  

• 添加新依赖（适配Spring 6）：

  <!-- OAuth2 Client -->
  <dependency>
      <groupId>org.springframework.security</groupId>
      <artifactId>spring-security-oauth2-client</artifactId>
      <version>6.x.x</version> <!-- 匹配Spring 6版本号 -->
  </dependency>
  <!-- 若需授权服务器功能 -->
  <dependency>
      <groupId>org.springframework.security</groupId>
      <artifactId>spring-security-oauth2-authorization-server</artifactId>
      <version>1.x.x</version> <!-- 对应Spring 6兼容版本 -->
  </dependency>
  

• 注意：新模块的API和旧版有差异，需要调整原有OAuth2相关配置代码，比如客户端注册、令牌管理等逻辑。

方案2：使用迁移工具临时过渡（不推荐长期使用） #

如果暂时无法重构代码，可以使用OpenRewrite这类工具，自动将代码中的javax.*替换为jakarta.*，同时对依赖做字节码层面的转换：

• 配置OpenRewrite插件，添加Jakarta迁移规则：

  <plugin>
      <groupId>org.openrewrite.maven</groupId>
      <artifactId>rewrite-maven-plugin</artifactId>
      <version>5.40.0</version>
      <configuration>
          <activeRecipes>
              <recipe>org.openrewrite.java.spring.boot3.SpringBoot3Migration</recipe>
              <recipe>org.openrewrite.java.jakarta.JavaxToJakarta</recipe>
          </activeRecipes>
      </configuration>
      <dependencies>
          <dependency>
              <groupId>org.openrewrite.recipe</groupId>
              <artifactId>rewrite-spring</artifactId>
              <version>5.40.0</version>
          </dependency>
      </dependencies>
  </plugin>
  

• 执行mvn rewrite:run完成代码和依赖的命名空间转换，但这种方式可能存在潜在兼容性问题，仅适合短期过渡。

关键注意点 #

• 优先选择方案1，这是Spring官方推荐的长期解决方案，后续会持续维护。
• 迁移过程中需全面测试OAuth2相关功能，包括令牌获取、验证、刷新等流程，避免出现业务断点。

内容的提问来源于stack exchange，提问作者collaborate.ever