如何用Maven及Java工具打包Jar时移除代码但保留源码？

针对你需要在打包Jar时移除大量指定方法/类但保留源码的需求，以下是几种可行的工具和实现方案：

1. 使用ProGuard（代码裁剪+混淆工具） #

ProGuard是Java生态中常用的字节码优化工具，可以通过配置规则移除未被使用或标记为无副作用的方法，源码不受影响。

配置步骤： #

在pom.xml中引入ProGuard Maven插件，并添加裁剪规则：

<plugin>
    <groupId>com.github.wvengen</groupId>
    <artifactId>proguard-maven-plugin</artifactId>
    <version>2.6.0</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>proguard</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <proguardVersion>7.2.1</proguardVersion>
        <options>
            <!-- 保留公共类/方法的对外结构，避免过度混淆 -->
            <option>-keep public class * { public protected *; }</option>
            <!-- 标记指定方法为无副作用，ProGuard会移除未被调用的这些方法 -->
            <option>-assumenosideeffects class com.yourpackage.ClassA {
                public void debugMethod1();
                public String debugMethod2();
            }</option>
            <!-- 批量规则可写入外部文件，便于维护400+方法 -->
            <option>-include ${project.basedir}/proguard-strip-rules.txt</option>
            <!-- 屏蔽移除代码导致的警告 -->
            <option>-dontwarn</option>
        </options>
        <injar>${project.build.finalName}.jar</injar>
        <outjar>${project.build.finalName}-stripped.jar</outjar>
    </configuration>
</plugin>

注意点： #

• -assumenosideeffects仅移除未被调用的方法；若方法被其他代码调用，需确保调用逻辑在打包环境中不会执行，否则运行时会抛出NoSuchMethodError。
• 外部规则文件可按格式批量添加类和方法，比如：

  -assumenosideeffects class com.yourpackage.ClassB {
      public void testMethod();
      public int calcMethod();
  }
  

2. ASM字节码操作（精确移除） #

ASM是轻量级字节码操作库，可编写自定义逻辑精准移除指定方法/类，不受方法是否被调用的限制。

实现步骤： #

1. 编写ASM ClassVisitor，过滤要移除的方法：

import org.objectweb.asm.ClassVisitor;
import org.objectweb.asm.MethodVisitor;
import org.objectweb.asm.Opcodes;

public class StripMethodVisitor extends ClassVisitor {
    // 可从配置文件读取批量方法名
    private static final String[] TARGET_METHODS = {"debugLog", "testValidate", "tempCalc"};

    public StripMethodVisitor(ClassVisitor cv) {
        super(Opcodes.ASM9, cv);
    }

    @Override
    public MethodVisitor visitMethod(int access, String name, String desc, String signature, String[] exceptions) {
        // 匹配到目标方法时返回null，跳过字节码生成
        for (String method : TARGET_METHODS) {
            if (method.equals(name)) {
                return null;
            }
        }
        return super.visitMethod(access, name, desc, signature, exceptions);
    }
}

2. 在pom.xml中配置ASM Maven插件，绑定到编译后阶段：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>asm-maven-plugin</artifactId>
    <version>1.0</version>
    <executions>
        <execution>
            <phase>process-classes</phase>
            <goals>
                <goal>transform</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <transformers>
            <transformer implementation="com.yourpackage.StripMethodVisitor"/>
        </transformers>
    </configuration>
</plugin>

优势： #

• 强制移除指定方法，无论是否被调用（需确保调用逻辑已被清理，否则运行报错）。
• 可扩展为从配置文件读取批量方法/类列表，适合400+方法的批量处理。

3. 注解驱动的编译时处理（最易维护） #

通过自定义注解标记要移除的方法/类，配合注解处理器在编译阶段自动移除，无需手动维护规则列表。

实现步骤： #

1. 定义保留到字节码阶段的注解：

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.CLASS)
public @interface RemoveInJar {
}

2. 给需要移除的方法/类添加注解：

public class BusinessClass {
    @RemoveInJar
    public void debugMethod() {
        // 调试逻辑
    }

    public void normalMethod() {
        // 业务逻辑
    }
}

3. 编写注解处理器，使用ASM移除带有@RemoveInJar的方法/类（实现逻辑类似方案2，只需在遍历类时检查注解标记）。

4. 在pom.xml中配置编译插件，指定注解处理器：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.1</version>
    <configuration>
        <annotationProcessors>
            <annotationProcessor>com.yourpackage.RemoveInJarProcessor</annotationProcessor>
        </annotationProcessors>
    </configuration>
</plugin>

优势： #

• 400+方法只需批量添加注解，维护成本极低。
• 编译时直接处理，不影响源码结构。

注意事项 #

• 无论使用哪种方案，都要确保被移除的方法/类在打包后的运行环境中不会被调用，否则会抛出NoSuchMethodError或NoClassDefFoundError。
• 建议先在测试环境验证打包后的Jar运行逻辑，避免遗漏调用点。

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