Java 从远程文件系统读取本地文件夹时 “无效签名” 错误的解决方法

2024-05-23 03:01:03

从远程文件系统访问本地文件夹的常见问题与解决方法

导言

在 Java 开发中，使用 java.nio.walkFileTree 从远程文件系统（如 macOS M1 文件系统）读取本地文件夹时，可能会遇到 “java.nio.file.FileSystemException: 无效签名” 错误。本文旨在深入探讨导致此错误的原因，并提供切实可行的解决方法。

问题原因

1. 文件路径太长

Windows API 存在路径长度限制（约 24KB），超出此限制会导致无效签名错误。

2. 文件系统权限问题

确保 Java 进程拥有读取和列出文件等访问远程文件系统的权限。

3. 网络问题

检查远程文件系统是否可访问，以及网络连接是否稳定。

解决方法

1. 使用相对路径

使用相对路径缩短文件路径长度。

2. 启用 SMB 签名

在 Windows 服务器上启用 SMB 签名，确保数据传输过程中的完整性。

3. 使用第三方库

例如 JNA（Java Native Access），绕过路径长度限制，直接访问底层 Windows API。

4. 使用循环遍历

避免使用 walkFileTree，改用循环遍历文件系统，自行处理路径长度问题。

5. 使用 Apache Commons VFS

Apache Commons VFS 提供访问不同文件系统的库，克服路径长度限制。

示例代码

使用 Apache Commons VFS 访问远程文件夹：

import org.apache.commons.vfs2.FileObject;
import org.apache.commons.vfs2.FileSystemManager;
import org.apache.commons.vfs2.VFS;
import org.apache.commons.vfs2.provider.sftp.SftpFileSystemConfigBuilder;

public class VFSExample {

    public static void main(String[] args) throws Exception {
        // 设置 SFTP 连接信息
        SftpFileSystemConfigBuilder configBuilder = SftpFileSystemConfigBuilder.getInstance();
        configBuilder.setHostname("192.168.1.110");
        configBuilder.setUsername("username");
        configBuilder.setPassword("password");

        // 创建文件系统管理器
        FileSystemManager manager = VFS.getManager();

        // 创建 SFTP 文件对象
        FileObject remoteFolder = manager.resolveFile("smb://192.168.1.110/TEMP/TEST/test", configBuilder);

        // 遍历文件夹内容
        for (FileObject file : remoteFolder.getChildren()) {
            System.out.println(file.getName().getBaseName());
        }
    }
}