这种情况我之前排查过好多次，大概率是几个常见的坑，咱们一步步来解决：

1. 优先开启被动模式（最常见原因） #

大部分现代FTP服务器默认要求使用被动模式，而PHP的ftp_connect默认是主动模式，这时候防火墙会拦截数据连接，导致切换目录、列文件失败。登录成功后马上开启被动模式就行：

$ftp_server = "server";
$conn_id = ftp_connect($ftp_server) or die("Couldn't connect to $ftp_server");
$login_result = ftp_login($conn_id, "user", "pass");

// 必须在登录后启用被动模式
if (!ftp_pasv($conn_id, true)) {
    die("Failed to switch to passive mode");
}

// 现在测试切换目录和列文件
if (ftp_chdir($conn_id, "your_target_dir")) {
    echo "Directory changed successfully!\n";
    $file_list = ftp_nlist($conn_id, ".");
    print_r($file_list);
} else {
    echo "Failed to change directory: " . error_get_last()['message'];
}

2. 检查目录路径的细节 #

• 大小写敏感：Linux/Unix系的FTP服务器对路径大小写严格，比如/Docs和/docs是完全不同的目录，别写错。
• 路径格式：必须用正斜杠/，不能用Windows的反斜杠\；另外要区分相对路径和绝对路径——登录后你默认在用户的家目录，比如/home/your_user，如果要进files子目录，相对路径写files，绝对路径写/home/your_user/files。

3. 验证用户权限 #

登录成功不代表你有目标目录的访问权限：

• 先试试列出当前目录：ftp_nlist($conn_id, ".")，如果连当前目录都列不出，基本就是权限问题。
• 联系FTP服务器管理员，确认该用户对目标目录有读权限（Linux下还需要执行权限才能进入目录）。

4. 排查防火墙和端口问题 #

• 主动模式下，FTP用21端口控制连接，20端口传输数据，如果你的本地防火墙或服务器防火墙拦截了20端口的入站连接，就会失败。
• 被动模式下，服务器会随机分配高端口，需要确保服务器防火墙开放了这些端口范围，同时你的本地防火墙允许出站到这些端口。

5. 开启调试，定位更精准的问题 #

• 打开PHP的错误提示：error_reporting(E_ALL); ini_set('display_errors', 1);，能看到更详细的错误信息。
• 用ftp_rawlist($conn_id, ".")代替ftp_nlist，有时候会返回服务器的原始错误提示。
• 先用命令行FTP工具（比如Windows的ftp命令、Linux的lftp）手动测试：如果命令行能正常切换目录、列文件，那问题出在代码；如果命令行也不行，就是服务器配置或权限的问题。

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