如何通过Java或Maven强制将backport包导入替换为java.util对应类

可实现编译期+运行期全链路替换，具体方案如下： #

1. 第一步：先全局排除backport原始依赖 #

先通过Maven规则彻底禁止传递引入的backport-util-concurrent组件，避免原始类残留：

<!-- 方式1：在第三方依赖声明处单独排除 -->
<dependency>
    <groupId>你的第三方库groupId</groupId>
    <artifactId>你的第三方库artifactId</artifactId>
    <version>xxx</version>
    <exclusions>
        <exclusion>
            <groupId>backport-util-concurrent</groupId>
            <artifactId>backport-util-concurrent</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<!-- 方式2：全局禁止该依赖引入（适合多模块项目） -->
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>backport-util-concurrent</groupId>
            <artifactId>backport-util-concurrent</artifactId>
            <version>3.1</version>
            <scope>provided</scope>
            <exclusions>
                <exclusion>
                    <groupId>*</groupId>
                    <artifactId>*</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>
</dependencyManagement>

2. 编译期替换：用Maven Shade插件做包重定向 #

这是最稳妥的方案，打包阶段直接修改第三方库的字节码，把所有edu.emory.mathcs.backport.java.util开头的引用替换为JDK原生java.util路径：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.5.1</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <relocations>
                    <relocation>
                        <!-- 匹配需要替换的包前缀 -->
                        <pattern>edu.emory.mathcs.backport.java.util</pattern>
                        <!-- 替换为JDK原生包前缀 -->
                        <shadedPattern>java.util</shadedPattern>
                    </relocation>
                </relocations>
                <!-- 过滤掉所有backport残留的类文件 -->
                <filters>
                    <filter>
                        <artifact>backport-util-concurrent:backport-util-concurrent</artifact>
                        <excludes>
                            <exclude>**/*</exclude>
                        </excludes>
                    </filter>
                </filters>
            </configuration>
        </execution>
    </executions>
</plugin>

该方案替换直接落地到打包后的字节码，无运行时额外开销，100%覆盖编译到打包全流程。 #

3. 运行期兜底替换：Java Instrumentation类重定向 #

如果存在运行时动态加载类的场景，可以配合Java Agent做兜底：

• 自定义ClassFileTransformer，在类加载阶段直接替换字节码中的edu/emory/mathcs/backport/java/util路径为java/util
• 启动应用时添加-javaagent:自定义agent包路径.jar参数即可生效
  注意：该方案仅覆盖运行时类加载阶段，建议和Shade插件方案组合使用避免遗漏。

4. 兼容性说明 #

backport-util-concurrent本身就是JDK1.5之前java.util.concurrent的向后兼容实现，API和JDK原生实现完全对齐，只要项目运行的JDK版本≥1.5，替换后几乎不会出现兼容性问题。仅需注意两种极端场景：

• 第三方库用到了backport独有的、JDK后续版本已删除的极冷门API，需单独做兼容性测试
• 代码中存在硬编码判断类全限定名的逻辑（如obj.getClass().getName()匹配），需单独适配

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