根本原因是没显式关闭连接或异常路径漏掉ssh.close()；Paramiko的SSHClient不会自动回收连接，未关闭连接会堆积并耗尽socket资源，导致卡死或“Channel is not open”异常。
Paramiko批量执行命令时连接不释放，脚本卡死或报 SSHException: Channel is not open
根本原因是没显式关闭连接，或在异常路径里漏掉 ssh.close()。Paramiko 的 SSHClient 不会自动回收连接，尤其在多线程/并发场景下，未关闭的连接会堆积、耗尽 socket 资源，最终触发超时或通道异常。
实操建议：
- 必须把
ssh.close()放进finally块，不能只写在正常流程末尾 - 避免在
exec_command()后直接调用stdout.read()之前就关连接——读取必须在连接存活时完成 - 如果用了
concurrent.futures.ThreadPoolExecutor，别在主线程里提前关 client；每个 worker 自己管理自己的连接生命周期 - 加个简单超时兜底：
ssh.connect(..., timeout=10)，防止某台服务器假死拖垮整个批次
用密码登录时反复提示 AuthenticationException，但手动 ssh 能通
常见于密码含特殊字符（如 $、!、&）或空格，Python 字符串未正确转义，或远程服务器禁用了密码认证（PasswordAuthentication no 在 /etc/ssh/sshd_config 中）。
实操建议：
- 先用
ssh -o PubkeyAuthentication=no user@host手动验证密码是否真能走通 - 检查目标服务器的
sshd_config，确认PasswordAuthentication yes且未被Match块覆盖 - 密码变量用原始字符串或双引号包裹，避免 shell 解析干扰（例如
password = r"mypass$123"） - 生产环境强烈建议切换为密钥认证：用
pkey=paramiko.RSAKey.from_private_key_file("/path/to/id_rsa")，并确保私钥无密码或已用ssh-agent加载
并发执行多台服务器时，部分主机输出乱序、结果混在一起
这是典型的多线程标准输出竞争问题。所有线程共用同一个 sys.stdout，print() 不是原子操作，中间可能被其他线程打断。
实操建议：
- 别直接
print()远程结果，改用线程安全的日志记录器，比如logging.getLogger().info(f"[{ip}] {output}") - 若坚持用 print，给每条输出加锁：
print_lock = threading.Lock()，然后在 print 前后加print_lock.acquire()/print_lock.release() - 更推荐方式：每个线程把结果存入队列（
queue.Queue），主线程统一收集、排序、输出，这样逻辑清晰且可追溯 - 注意
stdout.read()返回的是字节，记得 decode；若远程终端编码非 UTF-8（如 GBK），需显式指定：stdout.read().decode('gbk', errors='ignore')
exec_command() 执行多条命令（如 cd /tmp && ls）失败或目录切换无效
exec_command() 每次调用都是一个独立的 shell 会话，上一条命令的环境（如当前路径、环境变量）不会延续到下一条。所以 cd /tmp && ls 是有效的，但 cd /tmp 单独执行完再 exec ls 就仍在原目录。
实操建议：
- 把需要串联的命令用
;或&&拼成单个字符串传入：ssh.exec_command("cd /opt/app && ./start.sh") - 需要复杂交互（如输入 y/n、处理密码提示），用
invoke_shell()获取交互式 channel，再用channel.send()和channel.recv()控制流 - 执行脚本类任务，优先上传脚本文件后
exec_command("bash /tmp/deploy.sh")，比拼接长命令更可靠、易调试 - 注意 shell 类型差异：某些最小化系统默认用
dash而非bash，[[或source可能不支持，建议显式指定：exec_command("bash -c 'cd /tmp && ls'")
实际批量运维最易忽略的点是错误处理粒度——不是“连不上就跳过”，而是要区分 AuthenticationException（凭据错）、SSHException（网络或协议层异常）、socket.timeout（防火墙拦截）和命令级失败（stderr 非空但连接成功）。每种情况该重试、告警还是记日志，得按业务容忍度单独判断。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
