AIX 5.3系统Java程序读取特殊字符文件名显示问号问题排查

在客户的AIX 5.3系统上，使用Java程序（分别尝试过JSch和VFS2库）读取包含特殊字符的文件名时，特殊字符会被替换为问号，但本地开发环境无此问题。测试代码及开发环境输出如下：

测试代码 #

package com.example.ftp;

import com.jcraft.jsch.*;
import java.util.Vector;

public class Elmer1 {
    public static void main(String[] args) {
        String host = "aix";
        String username = "user";
        int port = 22;
        String password = "pass";  // Replace with your password
        String remoteDirectory = "/disk1/users/usr1";  // Replace with the remote folder path

        JSch jsch = new JSch();
        Session session = null;

        try {
            // Create the session object
            session = jsch.getSession(username, host, port);
            session.setPassword(password);  // Set password

            // Create properties for key exchange, ciphers, and host key algorithms
            java.util.Properties config = new java.util.Properties();

            session.setConfig(config);

            // Disable strict host key checking for testing purposes (optional)
            session.setConfig("StrictHostKeyChecking", "no");

            // Connect to the session
            session.connect();

            // Open an SFTP channel
            ChannelSftp channelSftp = (ChannelSftp) session.openChannel("sftp");
            channelSftp.connect();

            // List files and directories in the remote directory
            Vector<ChannelSftp.LsEntry> list = channelSftp.ls(remoteDirectory);

            System.out.println("Contents of " + remoteDirectory + ":");
            for (ChannelSftp.LsEntry entry : list) {
                if (entry.getAttrs().isDir()) {
                    // It's a directory
                    System.out.println("[DIR]  " + entry.getFilename());
                } else {
                    // It's a file
                    System.out.println("[FILE] " + entry.getFilename());
                }
            }

            // Disconnect when done
            channelSftp.disconnect();
            session.disconnect();

        } catch (JSchException | SftpException e) {
            e.printStackTrace();
        }
    }
}

开发环境输出 #

Contents of /disk1/users/usr1:
[DIR]  .
[DIR]  ..
[FILE] 99-4±±±±0A02-|PART±ASSEMBLY,±SAMPLE±IV-X.model

排查与解决思路 #

1. 检查AIX系统字符编码配置 #

• 执行locale命令查看AIX的LANG、LC_ALL等环境变量，确认当前系统字符集。AIX默认可能使用ISO-8859-1，若与Java程序编码不匹配会导致字符解析失败。
• 修改AIX系统字符集为UTF-8：编辑/etc/environment文件，设置LANG=en_US.UTF-8，重启系统生效；同时启动Java程序时添加参数-Dfile.encoding=UTF-8，强制Java使用UTF-8编码。

2. 显式配置SFTP通道的文件名编码 #

• 使用JSch时，在打开SFTP通道后添加编码设置：

  channelSftp.setFilenameEncoding("UTF-8");
  

  若AIX系统使用其他编码（如GBK），则替换为对应编码值。
• 检查AIX上SFTP服务器（如OpenSSH）配置，在sshd_config中确认是否有Subsystem sftp /usr/lib/ssh/sftp-server -u 000，确保服务器端支持UTF-8文件名传输。

3. 验证Java运行时编码 #

• 在程序中添加以下代码，打印Java实际使用的编码：

  System.out.println("File encoding: " + System.getProperty("file.encoding"));
  System.out.println("Default charset: " + Charset.defaultCharset().name());
  

• 若AIX上Java默认编码非UTF-8，除了添加-Dfile.encoding参数，还需检查JDK版本，建议升级到AIX 5.3兼容的最新IBM JDK（如JDK 6或7），旧版本可能存在编码支持缺陷。

4. 直接解析文件名原始字节 #

• 在AIX上执行ls /disk1/users/usr1 | od -c，查看特殊字符的原始字节序列。
• 在Java程序中，尝试绕过库的自动编码转换，直接获取文件名的字节数组再手动转换：

  // 示例：通过JSch获取原始字节并转换
  byte[] filenameBytes = entry.getFilename().getBytes("ISO-8859-1");
  String correctFilename = new String(filenameBytes, "UTF-8");
  

5. 配置VFS2的编码参数 #

• 使用VFS2连接SFTP时，需显式设置文件名编码：

  FileSystemOptions opts = new FileSystemOptions();
  SftpFileSystemConfigBuilder.getInstance().setFileNameEncoding(opts, "UTF-8");
  // 后续使用opts创建文件系统
  

• 确保使用的VFS2版本支持该配置项，若版本过旧则升级到最新兼容版本。

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