读取Jar包中META-INF/services服务声明文件失败，求解决方案

你的核心问题是Jar包内的META-INF/services目录无法通过直接读取URL流的方式获取文件列表——本地项目的目录是文件系统路径，能直接读取目录下的文件名；但Jar包的URL协议（jar:file:...）不支持直接读取目录内容，所以调用readLine()会返回null。

原代码的关键错误 #

1. 把META-INF/services目录当成文件读取：Jar包内的目录无法通过openStream()获取内容，返回的输入流是空的。
2. 路径拼接错误：用Windows的\\拼接URL，应该用URL标准的/分隔符。
3. 错误调用getResourceAsStream()：resource.getFile()返回的Jar路径格式（带!/）无法被getResourceAsStream()识别，会返回null。

解决方法一：直接遍历服务声明文件 #

针对本地文件系统和Jar包分别处理，读取所有META-INF/services下的服务声明文件：

import java.io.*;
import java.net.URI;
import java.net.URISyntaxException;
import java.net.URL;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.*;
import java.util.jar.JarEntry;
import java.util.jar.JarFile;

public class ServiceReader {
    public static void main(String[] args) {
        Map<String, String> serviceMap = new HashMap<>();
        ClassLoader classLoader = Thread.currentThread().getContextClassLoader();

        try {
            Enumeration<URL> serviceDirUrls = classLoader.getResources("META-INF/services");
            while (serviceDirUrls.hasMoreElements()) {
                URL dirUrl = serviceDirUrls.nextElement();
                String protocol = dirUrl.getProtocol();

                if ("file".equals(protocol)) {
                    // 处理本地项目的服务目录
                    Path dirPath = Path.of(dirUrl.toURI());
                    Files.list(dirPath)
                            .filter(Files::isRegularFile)
                            .forEach(filePath -> {
                                try {
                                    String interfaceName = filePath.getFileName().toString();
                                    // 读取文件内容，忽略注释和空行
                                    String content = Files.readString(filePath, StandardCharsets.UTF_8)
                                            .lines()
                                            .map(String::trim)
                                            .filter(line -> !line.isEmpty() && !line.startsWith("#"))
                                            .findFirst()
                                            .orElse("");
                                    serviceMap.put(interfaceName, content);
                                } catch (IOException e) {
                                    throw new RuntimeException(e);
                                }
                            });
                } else if ("jar".equals(protocol)) {
                    // 处理Jar包内的服务目录
                    String jarPathStr = dirUrl.getFile().split("!/")[0].replace("file:", "");
                    try (JarFile jarFile = new JarFile(URI.create(jarPathStr).getPath())) {
                        Enumeration<JarEntry> entries = jarFile.entries();
                        while (entries.hasMoreElements()) {
                            JarEntry entry = entries.nextElement();
                            String entryName = entry.getName();
                            // 筛选META-INF/services下的非目录条目
                            if (entryName.startsWith("META-INF/services/") && !entry.isDirectory()) {
                                String interfaceName = entryName.substring("META-INF/services/".length());
                                try (InputStream is = jarFile.getInputStream(entry);
                                     BufferedReader reader = new BufferedReader(new InputStreamReader(is, StandardCharsets.UTF_8))) {
                                    // 读取实现类名，忽略注释和空行
                                    String content = reader.lines()
                                            .map(String::trim)
                                            .filter(line -> !line.isEmpty() && !line.startsWith("#"))
                                            .findFirst()
                                            .orElse("");
                                    serviceMap.put(interfaceName, content);
                                }
                            }
                        }
                    }
                }
            }

            System.out.println("服务声明映射：" + serviceMap);
        } catch (IOException | URISyntaxException e) {
            throw new RuntimeException("读取服务声明文件失败", e);
        }
    }
}

代码说明

• 区分file和jar两种URL协议，分别处理本地目录和Jar包资源
• 读取文件时自动忽略注释（#开头）和空行，符合Java服务加载规范
• 使用NIO和流API简化代码，同时保证资源自动关闭

解决方法二：利用Java自带的ServiceLoader（推荐） #

如果你的最终目的是获取接口到实现类的映射，无需手动读取文件，直接用Java自带的ServiceLoader即可，它会自动扫描所有Jar包和本地项目的META-INF/services文件：

import java.util.HashMap;
import java.util.Map;
import java.util.ServiceLoader;

public class ServiceLoaderDemo {
    public static void main(String[] args) {
        // 替换为你要加载的接口类
        Class<?> targetInterface = YourServiceInterface.class;
        Map<Class<?>, Class<?>> serviceImplMap = new HashMap<>();

        ServiceLoader<?> loader = ServiceLoader.load(targetInterface);
        for (Object serviceInstance : loader) {
            serviceImplMap.put(targetInterface, serviceInstance.getClass());
        }

        System.out.println("接口与实现类映射：" + serviceImplMap);
    }
}

说明

• ServiceLoader会自动处理Jar包和本地资源的加载，无需手动处理URL和流
• 如果需要加载所有服务声明的接口，这种方式不太方便，但针对特定接口非常高效

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