SOA FTP Adapter报BINDING.JCA-11430：远程目录文件列表出错求助

我之前在使用SOA FTP Adapter做文件传输时，也碰到过一模一样的BINDING.JCA-11430错误，折腾了好一阵才搞定，给你整理几个关键的排查和修复方向：

BINDING.JCA-11430 Error in listing files in the remote directory。远程目录文件列表出错，无法列出远程目录中的文件，请确保FTP服务器设置正确。错误堆栈：at oracle.tip.adapter.ftp.FTPAgent.getFileList(FTPAgent.java:419).....

1. 先确认远程目录的正确性与权限 #

• 检查路径拼写：FTP服务器的路径大多区分大小写（尤其是Unix/Linux环境），比如配置的/opt/ftp/inbound不能写成/Opt/FTP/Inbound；Windows服务器注意斜杠方向，建议统一用正斜杠/避免格式错误。
• 验证目录存在性：手动用FTP客户端（比如FileZilla）登录同一账号，尝试访问目标目录，确认目录确实存在。
• 检查用户权限：确保FTP账号对目标目录拥有读权限——列文件列表依赖LIST命令，哪怕目录存在，没有读权限也会触发这个错误。

2. 排查FTP连接与模式配置 #

• 被动模式（PASV）问题：多数FTP服务器默认用被动模式，如果你所在网络有防火墙，要确认服务器的被动端口范围已开放，同时检查Adapter配置中UsePassiveMode属性是否正确开启。
• 协议匹配：如果服务器是SFTP（SSH文件传输），务必确保Adapter配置的是SFTP协议，而非普通FTP，否则会出现连接后无法执行列表命令的情况。
• 主机与端口验证：确认FTP服务器的主机地址、端口（默认FTP是21，SFTP是22）没有拼写错误，手动用客户端测试连接，确保能正常登录并操作目录。

3. 检查Adapter的配置属性 #

• 核对ListDirectory属性：这个属性直接指定要列表的远程目录，确保没有多余空格、特殊字符，建议用绝对路径避免歧义（有些FTP服务器登录后默认在用户根目录，相对路径也可，但绝对路径更稳妥）。
• 简化文件名匹配规则：如果File Name Pattern设置了过于严格的规则（比如错误的通配符），虽然不会直接导致无法列目录，但如果服务器返回的文件都不匹配，可能被误判为列表失败，可以先暂时设置为*测试。

4. 查看服务器端日志 #

如果上面的排查都没问题，建议登录FTP服务器查看日志（比如vsftpd的日志在/var/log/vsftpd.log），看看有没有该用户执行LIST命令时被拒绝的记录——比如服务器的chroot jail限制了用户的目录访问范围，导致无法访问目标目录。

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