Apache Commons IO是否有Jakarta命名空间版本？适配Spring Boot 3咨询

1. 是否存在Jakarta命名空间的Commons IO版本？ #

目前Apache Commons IO官方没有推出专门适配Jakarta命名空间的独立版本。包括2.17.0在内的所有2.x系列版本，仍基于旧的javax命名空间，暂未完成向Jakarta的迁移。

2. 无需替换库的兼容方案 #

如果不想花费大量时间替换依赖库，可采用以下低成本方案：

方式一：引入Jakarta迁移桥接依赖 #

Spring Boot 3生态提供了javax到Jakarta的桥接工具，可通过引入Tomcat的迁移依赖实现运行时自动映射：

<!-- Maven 依赖配置 -->
<dependency>
    <groupId>org.apache.tomcat</groupId>
    <artifactId>tomcat-jakartaee-migration</artifactId>
    <version>1.0.0</version>
    <scope>runtime</scope>
</dependency>

该依赖会在运行时将Commons IO中引用的javax类自动转向Jakarta对应类，无需修改业务代码。

方式二：JPMS模块重定位（适用于模块化项目） #

如果项目基于Java模块系统（JPMS），可在module-info.java中配置命名空间重定向：

module your.project.module {
    requires org.apache.commons.io;
    requires jakarta.servlet;
    
    // 重定向javax命名空间到jakarta
    opens com.your.package to org.apache.commons.io;
    exports com.your.package;
}

同时配合Maven编译插件添加参数：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
        <release>17</release>
        <compilerArgs>
            <arg>--add-modules</arg>
            <arg>jakarta.servlet</arg>
            <arg>--patch-module</arg>
            <arg>org.apache.commons.io=${project.build.directory}/jakarta-bridge.jar</arg>
        </compilerArgs>
    </configuration>
</plugin>

方式三：字节码修改（应急方案，不推荐） #

使用Byte Buddy等字节码工具，在构建阶段自动替换Commons IO类中的javax包名为jakarta，示例Maven插件配置：

<plugin>
    <groupId>net.bytebuddy</groupId>
    <artifactId>byte-buddy-maven-plugin</artifactId>
    <version>1.14.10</version>
    <executions>
        <execution>
            <goals>
                <goal>transform</goal>
            </goals>
            <configuration>
                <transformations>
                    <transformation>
                        <transformer>
                            <className>net.bytebuddy.implementation.transformer.StringValueTransformer</className>
                            <arguments>
                                <argument>javax\.([a-z.]+)</argument>
                                <argument>jakarta.$1</argument>
                            </arguments>
                        </transformer>
                    </transformation>
                </transformations>
            </configuration>
        </execution>
    </executions>
</plugin>

注意：该方式可能引发未知兼容性问题，仅适合临时应急。

3. 长期方案 #

Apache Commons IO社区已开启Jakarta迁移的讨论，可关注官方版本更新，后续版本大概率会推出适配Jakarta命名空间的正式版本。

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