使用wagon-ssh部署Maven仓库遭遇连接超时错误求助

我来帮你梳理这个问题——把旧的FTP Maven仓库改成SFTP后出现连接超时，这种情况一般要么是网络层面的拦截，要么是Maven配置的细节没改到位，咱们一步步来排查：

第一步：先确认SFTP服务器的基础连通性 #

连接超时最常见的原因是网络不通，先别着急看Maven配置，先用本地工具验证能不能连上服务器：

• 打开命令行，执行 sftp your-sftp-username@your-server-ip，如果这个命令也超时，那问题出在网络上：
  • 检查服务器的防火墙/安全组是否开放了22端口（SFTP默认端口，和FTP的21端口不一样，这是很容易踩的坑）；
  • 确认你的本地机器能ping通服务器（如果ping不通，可能是网络路由问题）；
  • 如果服务器用了非默认的SFTP端口，记得在命令里加上端口号：sftp -P 自定义端口 your-username@your-server-ip。

如果这个命令能成功连接，那咱们再看Maven的配置问题。

第二步：检查Maven配置的正确性 #

1. 确认pom.xml的distributionManagement配置 #

你需要把原来的ftp://协议改成sftp://，并且路径要正确，比如：

<distributionManagement>
  <repository>
    <id>sftp-repo</id> <!-- 这个id要和settings.xml里的server id一致 -->
    <url>sftp://your-server-ip/opt/maven-repo/releases</url>
  </repository>
  <snapshotRepository>
    <id>sftp-snapshot-repo</id>
    <url>sftp://your-server-ip/opt/maven-repo/snapshots</url>
  </snapshotRepository>
</distributionManagement>

2. 检查settings.xml的server配置 #

确保settings.xml里的server节点id和pom里的id完全匹配，并且登录信息正确：

• 如果用密码登录：

<servers>
  <server>
    <id>sftp-repo</id>
    <username>your-sftp-user</username>
    <password>your-sftp-password</password>
  </server>
  <!-- 如果有快照仓库，也要对应配置 -->
  <server>
    <id>sftp-snapshot-repo</id>
    <username>your-sftp-user</username>
    <password>your-sftp-password</password>
  </server>
</servers>

• 如果用SSH密钥登录：

<server>
  <id>sftp-repo</id>
  <username>your-sftp-user</username>
  <privateKey>/home/your-user/.ssh/id_rsa</privateKey>
  <!-- 如果密钥有密码，加上这行 -->
  <passphrase>your-key-passphrase</passphrase>
</server>

注意：密钥文件的权限要设置为600（chmod 600 ~/.ssh/id_rsa），否则Maven可能无法读取。

3. 确保引入了正确的Wagon依赖 #

Maven的SFTP传输需要依赖wagon-sftp插件，你需要在pom.xml的build节点里加上：

<build>
  <extensions>
    <extension>
      <groupId>org.apache.maven.wagon</groupId>
      <artifactId>wagon-sftp</artifactId>
      <version>3.5.3</version> <!-- 尽量用最新稳定版，避免旧版本的兼容性问题 -->
    </extension>
  </extensions>
</build>

旧版本的wagon-sftp可能存在连接bug，建议用3.x以上的版本。

第三步：查看更详细的Maven日志 #

如果上面的配置都没问题，你可以用-X参数运行deploy命令，获取更详细的调试日志：

mvn deploy -X

从日志里你可以看到Maven连接SFTP的具体步骤，比如是在认证阶段卡住，还是路径不存在，这能帮你定位更细节的问题。

常见的坑点提醒 #

• 不要把SFTP的端口和FTP搞混，默认SFTP是22，FTP是21；
• settings.xml里的server id必须和pom里的repository id完全一致，大小写也要匹配；
• 如果服务器是云服务器，别忘了检查云服务商的安全组规则，很多时候是安全组没开放端口导致的超时。

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