Spring Boot 3.x集成Apache DBCP2：Javax/Jakarta兼容升级问题求解

1. 使用DBCP2的Jakarta兼容快照版本 #

Apache DBCP2已在开发适配Jakarta规范的版本，目前提供带jakarta分类器的快照版本可用。在项目的pom.xml中引入该依赖：

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-dbcp2</artifactId>
    <version>2.13.0-SNAPSHOT</version>
    <classifier>jakarta</classifier>
</dependency>

注意：快照版本稳定性不如正式版，建议先在测试环境验证后再用于生产。

2. 借助Spring Boot迁移工具自动转换依赖 #

Spring Boot提供的迁移工具可自动将项目中javax相关依赖转换为jakarta对应包。在构建配置中添加该插件：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-migration-tool</artifactId>
            <version>3.2.0</version>
            <executions>
                <execution>
                    <goals>
                        <goal>migrate</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

执行mvn spring-boot:migrate命令后，工具会自动处理DBCP2相关的包路径转换。

3. 替换为Spring Boot推荐的连接池 #

若不想使用快照版本或迁移工具，可直接切换为Spring Boot 3.x官方推荐的连接池，这类组件原生适配Jakarta规范：

• HikariCP：Spring Boot默认连接池，无需额外配置，仅需引入依赖即可
• Tomcat JDBC连接池：同样完全适配Jakarta规范

以HikariCP为例，引入依赖的配置如下：

<dependency>
    <groupId>com.zaxxer</groupId>
    <artifactId>HikariCP</artifactId>
</dependency>

Spring Boot会自动将其设为默认连接池，无需修改额外配置。

4. 手动修改DBCP2源码并本地构建 #

如果上述方案均不适用，可克隆DBCP2的代码仓库，切换到Jakarta适配分支，将所有javax.sql.*、javax.transaction.*的导入替换为jakarta.sql.*、jakarta.transaction.*，之后本地构建jar包引入项目使用。

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