当前位置：首页 > 文章列表 > 文章 > java教程 > JAR文件Manifest读取失败原因与解决方法

JAR文件Manifest读取失败原因与解决方法

2025-08-20 20:03:35 0浏览收藏

在使用Java开发中，有时会遇到无法从JAR文件中读取自定义Manifest属性的问题，导致`Attributes.getValue(String)`方法返回null。本文针对这一常见问题，深入分析了其根本原因：**Manifest文件格式不规范，缺少必要的换行符**。通过详细的代码示例，展示了如何使用FileSystem API修改JAR包的MANIFEST.MF文件，并着重强调了在添加自定义属性以及文件末尾添加换行符的重要性。本文提供了经过验证的解决方案，帮助开发者轻松解决JAR包Manifest属性读取失败的问题，确保程序能够正确获取所需的配置信息。

无法从JAR文件中读取自定义Manifest属性？原因及解决方案

修改JAR包的Manifest文件并读取自定义属性，看似简单的操作，却可能遇到意想不到的问题。本文将深入探讨这一问题，并提供切实可行的解决方案。

你可能遇到这样的情况：你使用FileSystem API成功地将自定义属性添加到JAR包的MANIFEST.MF文件中，通过解压JAR包检查，确认属性已经存在。然而，当你使用JarFile API尝试读取这些属性时，却发现它们不见了，Attributes.getValue(String)方法返回null。

以下是一个示例代码，用于修改JAR包的Manifest文件并尝试读取自定义属性：

import java.io.*;
import java.net.URI;
import java.net.URISyntaxException;
import java.nio.file.*;
import java.nio.file.attribute.BasicFileAttributes;
import java.util.HashMap;
import java.util.Map;
import java.util.jar.Attributes;
import java.util.jar.JarFile;
import java.util.jar.Manifest;

public class ManifestModifier {

    public static void main(String[] args) throws IOException, URISyntaxException {
        File jar = new File("C:\\Users\\employee1234\\Desktop\\auth-0.1.3.jar"); // 替换为你的JAR文件路径
        String testVersion = "1.2.3";

        Map env = new HashMap<>();
        env.put("create", "true");

        // Mount the jar
        try (FileSystem fileSystem = FileSystems.newFileSystem(jarFileToURI(jar), env)) {
            // Read the manifest
            ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream();
            Path manifestPath = fileSystem.getPath("/META-INF/MANIFEST.MF");
            Files.copy(manifestPath, byteArrayOutputStream);

            // Convert the manifest bytes to a string and construct a string builder
            StringBuilder manifestData = new StringBuilder(byteArrayOutputStream.toString().trim());
            // Add the custom manifest attribute
            manifestData.append("\n");
            manifestData.append("Deployments-Version: ");
            manifestData.append(testVersion);

            // Write the manifest back to the jar
            Files.copy(new ByteArrayInputStream(manifestData.toString().getBytes()), manifestPath,
                    StandardCopyOption.REPLACE_EXISTING);

            // Try-with-resources closes the mounted jar
        }

        // This part doesn't work
        try (JarFile jarFile = new JarFile(jar)) {
            Manifest manifest = jarFile.getManifest();
            System.out.println(manifest.getMainAttributes().getValue("Deployments-Version"));
        }
    }

    // Stolen from java.io.File with some modifications
    private static URI jarFileToURI(File jarFile) throws URISyntaxException {
        String sp = slashify(jarFile.getAbsoluteFile().getPath(), false);
        if (sp.startsWith("//"))
            sp = "//" + sp;
        return new URI("jar:file", null, sp, null);
    }

    // Stolen from java.io.File;
    private static String slashify(String path, boolean isDirectory) {
        String p = path;
        if (File.separatorChar != '/')
            p = p.replace(File.separatorChar, '/');
        if (!p.startsWith("/"))
            p = "/" + p;
        if (!p.endsWith("/") && isDirectory)
            p = p + "/";
        return p;
    }
}

问题原因分析：

问题的根源在于Manifest文件的格式要求。每个属性条目必须以换行符分隔，并且整个Manifest文件也必须以换行符结尾。在上面的代码中，虽然添加了属性，但缺少了结尾的换行符，导致JarFile API无法正确解析Manifest文件。

解决方案：

确保在添加自定义属性后，以及整个Manifest文件的末尾，都添加换行符。修改代码如下：

manifestData.append("\n").append("Deployments-Version: ").append(testVersion).append("\n");

通过在属性值后添加额外的换行符，确保Manifest文件的格式正确，JarFile API就能正确读取自定义属性。

完整代码示例：

import java.io.*;
import java.net.URI;
import java.net.URISyntaxException;
import java.nio.file.*;
import java.nio.file.attribute.BasicFileAttributes;
import java.util.HashMap;
import java.util.Map;
import java.util.jar.Attributes;
import java.util.jar.JarFile;
import java.util.jar.Manifest;

public class ManifestModifier {

    public static void main(String[] args) throws IOException, URISyntaxException {
        File jar = new File("C:\\Users\\employee1234\\Desktop\\auth-0.1.3.jar"); // 替换为你的JAR文件路径
        String testVersion = "1.2.3";

        Map env = new HashMap<>();
        env.put("create", "true");

        // Mount the jar
        try (FileSystem fileSystem = FileSystems.newFileSystem(jarFileToURI(jar), env)) {
            // Read the manifest
            ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream();
            Path manifestPath = fileSystem.getPath("/META-INF/MANIFEST.MF");
            Files.copy(manifestPath, byteArrayOutputStream);

            // Convert the manifest bytes to a string and construct a string builder
            StringBuilder manifestData = new StringBuilder(byteArrayOutputStream.toString().trim());
            // Add the custom manifest attribute
            manifestData.append("\n").append("Deployments-Version: ").append(testVersion).append("\n");

            // Write the manifest back to the jar
            Files.copy(new ByteArrayInputStream(manifestData.toString().getBytes()), manifestPath,
                    StandardCopyOption.REPLACE_EXISTING);

            // Try-with-resources closes the mounted jar
        }

        // This part now works
        try (JarFile jarFile = new JarFile(jar)) {
            Manifest manifest = jarFile.getManifest();
            System.out.println(manifest.getMainAttributes().getValue("Deployments-Version"));
        }
    }

    // Stolen from java.io.File with some modifications
    private static URI jarFileToURI(File jarFile) throws URISyntaxException {
        String sp = slashify(jarFile.getAbsoluteFile().getPath(), false);
        if (sp.startsWith("//"))
            sp = "//" + sp;
        return new URI("jar:file", null, sp, null);
    }

    // Stolen from java.io.File;
    private static String slashify(String path, boolean isDirectory) {
        String p = path;
        if (File.separatorChar != '/')
            p = p.replace(File.separatorChar, '/');
        if (!p.startsWith("/"))
            p = "/" + p;
        if (!p.endsWith("/") && isDirectory)
            p = p + "/";
        return p;
    }
}

总结与注意事项：

修改JAR包的Manifest文件时，务必注意Manifest文件的格式要求。
确保每个属性条目以及整个Manifest文件都以换行符结尾。
使用FileSystem API修改JAR包内容时，需要正确处理文件流的打开和关闭，避免资源泄露。
在实际应用中，应根据具体需求选择合适的API来操作JAR包，例如，如果只是读取Manifest文件，使用JarFile API即可。如果需要修改JAR包内容，则需要使用FileSystem API。

通过理解Manifest文件的格式要求，并正确地添加换行符，你就可以成功地从JAR文件中读取自定义Manifest属性了。希望本文能够帮助你解决类似问题。

理论要掌握，实操不能落！以上关于《JAR文件Manifest读取失败原因与解决方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！