FTP连接失败主因有四：一是宝塔禁用ftp_connect等函数，需在PHP设置中移除并重启服务；二是主动模式被防火墙拦截，应启用被动模式并开放对应端口段；三是FTP账号根目录路径错误或权限不足，须核对绝对路径及属主为www；四是协议混淆，ftp_connect不支持FTPS/SFTP，FTPS需ftp_ssl_connect且启用OpenSSL，SFTP应改用phpseclib。
FTP 连接被拒绝：检查 ftp_connect() 是否被禁用
宝塔面板默认会禁用部分高危函数，ftp_connect() 就在黑名单里。PHP 脚本调用时直接返回 false，错误日志里可能只显示“Connection refused”或空响应，实际根本没发出去请求。
- 进宝塔 → 网站 → PHP 设置 → 禁用函数，确认
ftp_connect、ftp_login、ftp_pasv未出现在禁用列表中 - 改完记得重启 PHP 服务（不是重载），否则不生效
- 临时测试可在脚本开头加
var_dump(function_exists('ftp_connect'));验证函数是否可用
主动模式连不上：ftp_pasv() 必须设为 false 或按需切换
宝塔服务器通常在 NAT 或云厂商安全组后，FTP 主动模式（PORT）会让服务端反连客户端的随机高端口，这个端口几乎肯定被拦截，导致卡在登录后无响应或目录列表失败。
- 代码中显式关闭被动模式：
ftp_pasv($conn, false);（仅适用于服务端能直连客户端 IP 的极少数场景） - 更稳妥做法是开启被动模式 + 开放被动端口段：在 FTP 服务配置（如 Pure-FTPd）中指定被动端口范围（如
30000-30100），再在宝塔安全组/云防火墙放行该端口段 - 调用
ftp_pasv($conn, true)后，务必检查返回值是否为true，否则后续操作大概率失败
账号无法登录：FTP 用户归属与权限路径不匹配
宝塔建站用的是网站根目录（如 /www/wwwroot/example.com），但 FTP 账号若指向错误路径，或用户未绑定到对应目录，会导致登录成功却 ftp_chdir() 失败、写入无权限、甚至登录直接被拒。
- 在宝塔 → FTP → 编辑账号，确认「根目录」字段填的是绝对路径，且与网站实际路径一致（注意末尾不带斜杠）
- 检查该目录属主是否为
www（宝塔默认运行用户），执行ls -ld /www/wwwroot/example.com查看；若属主是root，需chown -R www:www /www/wwwroot/example.com - FTP 账号的「最大连接数」「速度限制」等若设为 0，也可能导致登录被静默拒绝，建议设为合理值（如连接数 5）
SSL/TLS 报错或超时：明确区分 FTP、FTPS、SFTP 协议
PHP 的 ftp_connect() 原生只支持明文 FTP；如果 FTP 服务强制启用 TLS（即 FTPS），而代码没做 SSL 封装，就会连接几秒后超时，错误信息可能是 Failed to connect to xxx port 21: Connection timed out，看似网络问题，实为协议不匹配。
立即学习“PHP免费学习笔记（深入）”；
- 确认你用的是 FTPS（FTP over SSL，端口通常是 21 或 990）还是 SFTP（SSH File Transfer Protocol，端口 22）——二者完全不兼容，PHP 原生 FTP 扩展不支持 SFTP
- 若必须用 FTPS，得改用
ftp_ssl_connect()，且 PHP 编译时需启用 OpenSSL，并确保证书可校验（内网环境常因证书问题失败） - 更推荐方案：换用
phpseclib库处理 SFTP，或用宝塔自带的「文件」功能替代脚本直连
