Ant SCP任务抛出java.net.UnknownHostException问题排查求助

这种情况我之前也碰到过好几次——明明手动SSH完全正常，但Ant用JSch就是报java.net.UnknownHostException，结合你描述的场景，咱们一步步排查可能的问题：

1. 先确认Ant脚本的主机配置是否准确 #

• 如果你在脚本里用的是主机名而非IP，先换成IP试试：有时候JVM的DNS解析逻辑和系统不一样，哪怕系统能正常解析主机名，JVM可能因为配置（比如IPv6优先级、未读取系统resolv.conf）导致解析失败。
• 如果已经用了IP，仔细检查有没有拼写错误：比如多打了空格、少了小数点，或者复制粘贴时带了不可见字符（这种隐形坑真的很常见）。

2. 核对密钥文件的路径配置 #

• 你手动SSH用的密钥路径，和Ant脚本里指定的是不是完全一致？如果脚本用了相对路径，一定要注意Eclipse运行Ant时的工作目录（可以在Eclipse的Run Configuration里查看Working Directory选项），相对路径是基于这个目录的。
• 建议直接用绝对路径指定密钥文件，比如/home/yourusername/.ssh/id_rsa，彻底避免相对路径带来的歧义。

3. 检查Ant运行的用户与手动SSH的用户是否一致 #

• 如果你用普通用户手动SSH，但Eclipse是通过sudo或者其他用户启动的，那Ant运行时的身份就不一样，对应的密钥文件路径、权限都会出现问题。
• 可以在Ant脚本里加个简单任务输出当前用户，快速验证：

  <exec executable="whoami" outputproperty="current.user"/>
  <echo message="Ant running as user: ${current.user}"/>
  

  看看和你手动SSH的用户是不是同一个。

4. 密钥文件的权限是否符合JSch要求 #

• JSch对密钥文件的权限要求非常严格，必须是600（只有所有者可读可写），如果权限太松，JSch会直接拒绝使用该密钥。
• 手动检查权限：ls -l ~/.ssh/id_rsa，确保输出是-rw-------。如果不是，用chmod 600 ~/.ssh/id_rsa修正；另外~/.ssh目录的权限也要设置为700：chmod 700 ~/.ssh。

5. 验证Ant与JSch版本的兼容性 #

• 虽然你已经把jsch-0.1.54.jar和ant-jsch.jar放到了$ANT_HOME/lib，但部分Ant版本和JSch版本存在兼容性问题：比如Ant 1.9.x搭配jsch-0.1.54没问题，但Ant 1.11.x以上可能需要更新JSch到0.1.55及以上版本。
• 可以试试替换成最新稳定版的JSch jar包，再重新运行任务。

6. 排查代理或防火墙的干扰 #

• 手动SSH可能用了系统代理或者SSH配置里的代理，但Ant运行的JVM环境没有配置代理，导致无法建立连接。可以在Eclipse的Ant运行配置里添加JVM参数关闭代理：-Djava.net.useSystemProxies=false；如果确实需要代理，再手动指定代理参数。
• 另外，极少数情况下系统防火墙会对不同进程设置不同规则，虽然ping能通，但Ant进程可能被阻止访问SSH（22）端口，可以临时关闭防火墙测试一下。

7. 密码短语的传递是否正确 #

• 如果你的密钥有密码短语，Ant脚本里是不是正确设置了passphrase属性？比如：

  <scp file="local-file.txt" todir="remote-user@x.x.x.x:/target/path" keyfile="/home/yourusername/.ssh/id_rsa" passphrase="your-passphrase"/>
  

• 注意密码短语里如果有特殊字符（比如&、$），需要用XML实体转义，比如&代替&，$代替$，否则XML解析出错会间接导致连接失败。

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