如何在Java程序中正确编辑JAR文件并替换其中的占位字符串

JAR本质是遵循ZIP压缩格式的二进制归档包，并非纯文本文件。你之前将全量二进制按UTF-8解码为字符串、替换后再编码写出的操作，会直接破坏ZIP结构里的压缩块、中央目录索引，导致文件解析失败、体积异常膨胀，和实际内容无关。

核心处理逻辑：跳过全量文本读取的操作，使用JDK内置的JAR标准API逐条目处理归档内容，仅对存储占位字符串的目标条目做定向替换，其余条目完整原样复制，最终重新生成结构合法的JAR包。

实现注意要点 #

• 仅对目标条目做内容修改，不改动ZIP/JAR的整体结构、条目的存储顺序、压缩参数
• 如果占位字符串硬编码在.class二进制文件中，必须提前在预编译的基础JAR里，将占位串预留为固定长度：
  • 替换前对用户输入做长度校验，输入长度超过预留占位长度时直接抛出错误，避免修改class文件内部的常量池偏移
  • 用户输入长度不足时，用指定填充字符（比如空格）补齐到和占位串完全一致的长度，防止破坏class文件的二进制结构
• 如果占位字符串存储在普通文本资源（如properties配置、JSON文件）中，无长度限制，可直接替换

可直接复用的实现代码 #

import java.io.IOException;
import java.io.UncheckedIOException;
import java.io.InputStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.jar.JarEntry;
import java.util.jar.JarFile;
import java.util.jar.JarOutputStream;
import java.nio.charset.StandardCharsets;

public class JarCustomizer {
    // 预编译时植入的固定长度占位串，根据实际需求调整预留长度
    private static final String BASE_PLACEHOLDER = "CUSTOM_USER_CONTENT_PLACEHOLDER____________________";
    private static final int PLACEHOLDER_LENGTH = BASE_PLACEHOLDER.length();
    // 需要替换占位串的目标条目路径
    private static final String TARGET_ENTRY = "me/ruben/Main.class";

    public static void buildCustomJar(Path baseJarPath, Path outputJarPath, String userInput) throws IOException {
        // 适配用户输入长度，匹配占位串固定长度
        String finalContent = userInput;
        if (finalContent.length() > PLACEHOLDER_LENGTH) {
            throw new IllegalArgumentException("用户输入超过预留占位长度，请增大基础JAR内的占位串长度后重新编译");
        }
        finalContent = finalContent + " ".repeat(PLACEHOLDER_LENGTH - finalContent.length());

        // 逐条目读取基础JAR，写出定制化JAR
        try (
            JarFile baseJar = new JarFile(baseJarPath.toFile());
            JarOutputStream outputStream = new JarOutputStream(Files.newOutputStream(outputJarPath))
        ) {
            baseJar.stream().forEach(entry -> {
                try {
                    // 保留原条目的压缩属性，避免破坏结构
                    JarEntry outputEntry = new JarEntry(entry.getName());
                    outputEntry.setMethod(entry.getMethod());
                    outputEntry.setTime(entry.getTime());
                    outputStream.putNextEntry(outputEntry);

                    // 读取条目原始字节
                    try (InputStream entryStream = baseJar.getInputStream(entry)) {
                        byte[] entryBytes = entryStream.readAllBytes();
                        // 仅对目标条目做字符串替换
                        if (TARGET_ENTRY.equals(entry.getName())) {
                            String entryText = new String(entryBytes, StandardCharsets.UTF_8);
                            entryText = entryText.replace(BASE_PLACEHOLDER, finalContent);
                            entryBytes = entryText.getBytes(StandardCharsets.UTF_8);
                        }
                        outputStream.write(entryBytes);
                    }
                    outputStream.closeEntry();
                } catch (IOException e) {
                    throw new UncheckedIOException(e);
                }
            });
        }
    }
}

• 不要改动META-INF目录下的签名文件，如果基础JAR做了代码签名，替换内容后需要重新执行JAR签名流程，否则JVM会因签名校验失败拒绝运行
• 不要打乱原JAR内的条目存储顺序，部分严格的类加载器会对条目顺序做校验
• 禁止直接将JAR全量字节转字符串处理，这是导致JAR结构损坏的核心原因

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