paramiko连接报“no authentication methods available”主因是未正确加载私钥或未传密码，需检查私钥路径、是否加密及服务端sshd_config认证配置；建连前应设autoaddpolicy并确保超时、keepalive等参数合理。
paramiko 连接失败时常见报错和修复方法
直接用 paramiko.SSHClient() 建连却报 SSHException: No authentication methods available，基本是没加载密钥或密码没传对。别急着换库，先确认三件事：
- 私钥路径是否正确？用
os.path.exists()检查，别依赖相对路径——脚本在 cron 里跑时工作目录可能不是你预期的 - 密钥是否带密码？如果
key_filename指向一个加密的id_rsa，必须显式传password=xxx给connect()，光靠key_filename不够 - 目标服务器的
/etc/ssh/sshd_config是否允许你用的认证方式？比如禁用了密码登录，但你又没配好密钥，就会卡在这里
建议连接前加一句 client.set_missing_host_key_policy(paramiko.AutoAddPolicy())，否则首次连接会因 host key 未验证而抛异常——这在自动化场景里很常见，但生产环境慎用，应改用 WarningPolicy 或预存 known_hosts。
用 scp 协议传文件时权限和路径容易出错
scp 库（如 scp.SCPClient）底层复用 paramiko 的 transport，但路径处理比想象中脆弱。最常踩的坑是：本地路径写成 "./data/file.txt"，远程路径写成 "~/backup/"，结果报 FileNotFoundError 或静默失败。
- 远程路径必须是绝对路径，
~不会被自动展开——得先用exec_command("echo $HOME")拿到真实路径再拼接 - 目标目录必须已存在，
scp不会自动创建父目录；想传到/var/log/app/2024/，得先mkdir -p，否则失败 - 注意用户权限：如果用普通用户登录，但目标路径属 root，即使有写权限也传不进去——检查
ls -ld /path/to/dir的 group 和 sticky bit
示例片段：
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
with SCPClient(ssh.get_transport()) as scp:
scp.put('local.tar.gz', '/opt/app/releases/latest.tar.gz') 这行看着简单，但若 /opt/app/releases/ 不存在或权限不足，就直接崩。
大文件分发卡住或超时怎么办
默认 paramiko 的 socket 超时是 30 秒，传几百 MB 的日志包很容易触发 socket.timeout。不能只调大 timeout 参数，还得开 keepalive 防 SSH 中间设备断连。
- 建连时加参数：
connect(..., timeout=300, banner_timeout=200)；banner_timeout是为防某些老旧 SSH 服务响应慢 - 启用心跳：
ssh.get_transport().set_keepalive(30)，每 30 秒发一次空包，避免被防火墙或负载均衡器踢掉 - 大文件建议用
scp.put()的preserve_times=True和recursive=False（除非真要传目录），否则递归+时间戳校验会显著拖慢速度
另外，别用 scp 库传超 2GB 文件——它把整个文件读进内存再分块发，OOM 风险高；换成 sftp = ssh.open_sftp() + sftp.put() 更稳，后者支持流式上传。
并发分发多台服务器时状态难追踪
for 循环挨个连服务器传文件，某台失败就整个流程中断，而且不知道哪台成功哪台挂了。用 concurrent.futures.ThreadPoolExecutor 并发更实用，但要注意 paramiko 实例不能跨线程共享。
- 每个线程必须新建自己的
SSHClient和SCPClient，别共用一个 client 对象 - 用
as_completed()收集结果，而不是wait()；失败时捕获具体异常（如AuthenticationException、SSHException），并打印对应 hostname - 加个简单重试逻辑：对网络抖动导致的
socket.error，最多重试 2 次，别无脑死循环
真正麻烦的是：不同服务器的 Python 环境版本、OpenSSH 版本、甚至 SELinux 策略都可能不同，同一份脚本在 A 机成功，B 机卡在 sftp 初始化——这种差异只能靠日志逐台排查，没法一劳永逸。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
