错误无法取得目录列表
错误无法取得目录列表
服务器返回的错误响应里，那行字刺眼地横在屏幕中央。无法我盯着它，目录像盯着一张被退回的列表汇款单——明明地址没错，钱也备好了，错误可对方就是无法不肯收。FTP客户端显示连接成功，目录用户名密码都通过了验证，列表偏偏在列出文件这一步卡死。错误这不是无法第一次了，每次换新服务器，目录总有那么几次要跟这个错误较劲。列表
第一次遇到时，错误我以为是无法权限问题。把目录权限从755改成777，目录又把属主从root改成www-data，折腾了半小时，错误纹丝不动。后来才反应过来，问题出在被动模式上。服务器防火墙只开放了21端口，被动模式需要的动态端口全被挡在外面。客户端傻乎乎地等着服务器开新端口传数据，服务器那边防火墙却把路堵得死死的。两边干瞪眼，最后客户端抛出一句"无法取得目录列表"——这错误信息翻译得可真含蓄，明明就是"我连不上你"的意思。
还有一次更隐蔽。服务器是Windows IIS搭建的FTP，默认编码是GBK，我的客户端用UTF-8去解析目录名。中文文件名全变成了乱码，客户端一看到乱码就慌了神，直接放弃列目录。那次排查花了我一下午，最后是拿浏览器直接访问FTP地址才看出端倪——浏览器自动做了编码转换，目录列表显示正常，客户端却不行。你说这算谁的错？两边都没错，可结果就是错。
说实话，这个错误信息最坑的地方在于它太笼统了。它不告诉你到底是连接超时、认证失败、还是协议不匹配，就丢给你一句"无法取得目录列表"让你自己猜。我见过新手在论坛里问这个问题，底下回复什么都有：有人说是防火墙问题，有人说是SELinux捣乱，还有人建议换个FTP软件试试。结果提问的人挨个试了一遍，最后发现是路由器NAT没做端口映射——服务器在内网，外网根本访问不到数据端口。
后来我学乖了。遇到这个错误，第一件事就是打开客户端的调试日志。日志里会记录每次数据连接的尝试过程和失败原因。大多数时候，问题都出在数据连接上——主动模式还是被动模式、防火墙是否放行、路由器是否支持FTP穿透。把这些捋顺了，错误自然消失。
但有些时候，错误就是错误本身。上周我帮朋友调试一台老掉牙的Linux服务器，系统还是CentOS 5，FTP服务是vsftpd。配置看着没问题，防火墙也关了，可就是列不出目录。最后我检查了vsftpd的日志，发现它压根没收到数据连接的请求。查了半天，原来是服务器上的iptables规则里有一条DROP规则，把高端口的连接全丢了。删掉那条规则，问题立刻解决。
你看，这个错误像是个万能背锅侠，所有网络层、传输层、应用层的问题都能往它身上推。它不告诉你真相，只给你一个结果。你只能顺着线索自己找，像侦探破案一样。有时候线索藏在防火墙规则里，有时候藏在编码设置里，还有时候藏在你压根想不到的地方——比如某次我更新了客户端版本，新版本默认改用SFTP协议，而服务器只支持FTP，结果报的也是这个错。
现在再看到"无法取得目录列表"，我已经不慌了。先深呼吸，然后按部就班地检查：模式切换试试，端口放行确认下，编码格式调整下，日志翻出来看看。大多数时候，问题在十分钟内就能定位。剩下那百分之十，可能是你永远想不到的奇葩原因——比如服务器时间不对导致TLS握手失败，或者某个安全软件偷偷拦截了数据连接。
这错误就像个脾气古怪的老头，你跟他急他就跟你耗着，你静下心来慢慢聊，他反而愿意告诉你点门道。