服务模式下Java程序调用File.listRoots()无法显示映射驱动器的解决问询

这个问题我之前排查过，核心原因是Windows服务的运行上下文限制：默认情况下Windows服务是在本地系统账户（Local System）下运行的，而网络映射驱动器是和特定用户会话绑定的——只有创建映射的用户会话才能识别这些驱动器，本地系统账户无法跨会话访问这类资源，所以File.listRoots()只能返回本地驱动器。

下面给你两种可行的解决方案，按需选择：

方案1：修改服务的运行账户（最简单快捷） #

直接把Java服务的运行账户改成当前登录的用户账户（或者拥有网络资源访问权限的域账户），这样服务就会在该用户的上下文下运行，File.listRoots()就能正常返回所有映射驱动器了。

操作步骤：

• 打开「服务」控制台，找到你的Java服务
• 右键选择「属性」→「登录」选项卡
• 选择「此账户」，输入有权访问映射盘的用户账户和密码，点击确定
• 重启服务即可生效

注意：如果是域环境，要确保账户有目标共享文件夹的访问权限；另外如果用户注销，服务可能会被终止（可以勾选「允许服务与桌面交互」缓解，但不建议在生产环境使用）

方案2：通过Windows API枚举网络资源（无需修改服务账户） #

如果不想改动服务的运行账户，可以直接调用Windows的网络资源枚举API来获取映射驱动器，绕过JVM对File.listRoots()的限制。这里推荐用JNA（Java Native Access）来调用Windows API，比JNI更简洁易维护。

步骤1：引入JNA依赖 #

如果用Maven，在pom.xml里添加：

<dependency>
    <groupId>net.java.dev.jna</groupId>
    <artifactId>jna</artifactId>
    <version>5.13.0</version>
</dependency>
<dependency>
    <groupId>net.java.dev.jna</groupId>
    <artifactId>jna-platform</artifactId>
    <version>5.13.0</version>
</dependency>

步骤2：示例代码 #

import com.sun.jna.Native;
import com.sun.jna.platform.win32.WinNetWk;
import com.sun.jna.platform.win32.WinNT;
import com.sun.jna.ptr.IntByReference;
import com.sun.jna.ptr.PointerByReference;

import java.util.ArrayList;
import java.util.List;

public class NetworkDriveLister {

    public static List<String> getNetworkDrives() {
        List<String> drives = new ArrayList<>();

        // 初始化网络资源枚举句柄
        PointerByReference hEnum = new PointerByReference();
        int result = WinNetWk.INSTANCE.WNetOpenEnum(WinNetWk.RESOURCE_CONNECTED,
                WinNetWk.RESOURCETYPE_DISK,
                0,
                null,
                hEnum);

        if (result != WinNT.NO_ERROR) {
            return drives;
        }

        try {
            IntByReference entriesRead = new IntByReference();
            IntByReference totalEntries = new IntByReference();
            PointerByReference buffer = new PointerByReference();

            while (true) {
                // 枚举网络资源
                result = WinNetWk.INSTANCE.WNetEnumResource(hEnum.getValue(),
                        entriesRead,
                        buffer,
                        totalEntries);

                if (result == WinNT.NO_ERROR || result == WinNetWk.ERROR_MORE_DATA) {
                    WinNetWk.NETRESOURCE resource = new WinNetWk.NETRESOURCE(buffer.getValue());
                    resource.read();

                    // 筛选出有本地驱动器号的映射资源
                    if (resource.lpLocalName != null && !resource.lpLocalName.isEmpty()) {
                        drives.add(resource.lpLocalName);
                    }

                    // 释放缓冲区资源
                    WinNetWk.INSTANCE.WNetFreeResource(buffer.getValue());

                    if (result == WinNT.NO_ERROR) {
                        break;
                    }
                } else {
                    break;
                }
            }
        } finally {
            // 关闭枚举句柄，避免资源泄漏
            WinNetWk.INSTANCE.WNetCloseEnum(hEnum.getValue());
        }

        return drives;
    }

    public static void main(String[] args) {
        List<String> networkDrives = getNetworkDrives();
        System.out.println("网络映射驱动器列表：");
        networkDrives.forEach(System.out::println);
    }
}

代码说明： #

• 调用WNetOpenEnum初始化枚举，指定枚举已连接的磁盘类网络资源
• 通过WNetEnumResource循环枚举所有资源，筛选出带有本地驱动器号的条目（即映射驱动器）
• 全程注意资源释放，避免内存泄漏

注意：服务账户需要有「访问网络资源」的权限，如果用本地系统账户，要确保它被添加到目标共享的权限列表中

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