前言：当Java遇上SFTP，是技术还是玄学？

作为一个常年和服务器“打架”的博主，我见过太多人对着SFTP抓狂：“这玩意儿咋用Java传文件？难道要祭出祖传的FTP？” 别急！今天咱们就用代码和段子，把这事儿讲明白——Java上传SFTP服务器，比点外卖还简单（前提是别手抖输错密码）。

一、SFTP是啥？和FTP有啥区别？（专业但不说人话版）

- FTP（File Transfer Protocol）：老古董协议，传输像裸奔（默认不加密），密码和文件容易被隔壁黑客“截胡”。

- SFTP（SSH File Transfer Protocol）：FTP的“西装暴徒版”，通过SSH加密传输，安全性直接拉满。

举个栗子🌰：

FTP像用明信片寄银行卡密码，SFTP则是把密码锁进保险箱再让特种兵护送。你说选哪个？

二、Java上传SFTP的三大神器（附代码实战）

1. JSch库：江湖老炮儿，稳如泰山

[JSch](http://www.jcraft.com/jsch/) 是Java圈公认的SFTP扛把子，代码简洁到让你怀疑人生。

```java

import com.jcraft.jsch.*;

public class SftpUploader {

public static void main(String[] args) {

String host = "你的服务器IP";

int port = 22; // SFTP默认端口

String user = "用户名";

String password = "密码（别写成123456）";

String localFile = "本地文件路径（比如C:/表情包/狗头.jpg）";

String remoteDir = "远程目录（比如/upload/狗头保命）";

try {

JSch jsch = new JSch();

Session session = jsch.getSession(user, host, port);

session.setPassword(password);

session.setConfig("StrictHostKeyChecking", "no"); // 跳过主机验证（测试用，生产环境别偷懒！）

session.connect();

ChannelSftp sftpChannel = (ChannelSftp) session.openChannel("sftp");

sftpChannel.connect();

sftpChannel.put(localFile, remoteDir); // 上传！

System.out.println("文件上传成功！远程路径：" + remoteDir);

sftpChannel.disconnect();

session.disconnect();

} catch (JSchException | SftpException e) {

System.out.println("翻车了！错误信息：" + e.getMessage());

}

}

}

```

避坑指南🚨：

- `StrictHostKeyChecking`设为`no`是为了省事，但正式环境请老老实实配置known_hosts！

- 如果连不上，先检查防火墙是否放行了22端口（别问我怎么知道的）。

2. Apache Commons VFS：抽象层大佬，一套代码通吃所有协议

如果你还想顺便支持FTP、HTTP甚至网盘，[Commons VFS](https://commons.apache.org/proper/commons-vfs/) 是你的瑞士军刀。

import org.apache.commons.vfs2.*;

import org.apache.commons.vfs2.provider.sftp.SftpFileSystemConfigBuilder;

public class VfsSftpUpload {

public static void main(String[] args) throws FileSystemException {

String sftpUri = "sftp://用户名:密码@服务器IP/远程路径/文件名";

String localFile = "本地文件路径";

FileSystemManager fsManager = VFS.getManager();

FileObject local = fsManager.resolveFile(localFile);

FileObject remote = fsManager.resolveFile(sftpUri,

SftpFileSystemConfigBuilder.getInstance().createDefaultOptions());

remote.copyFrom(local, Selectors.SELECT_SELF);

System.out.println("上传完成！");

local.close();

remote.close();

优势🎯：

- 代码更抽象，换协议只需改个URL（比如`sftp://`换成`ftp://`）。

- 支持连接池、缓存等高级玩法。

3. Spring Integration：企业级玩家的优雅选择

如果你在用Spring Boot，直接上[Spring Integration SFTP](https://spring.io/projects/spring-integration)，配置像喝奶茶一样简单：

```yaml

application.yml

sftp:

host: your-host

port: 22

user: your-user

password: your-password

remote-dir: /upload/

@SpringBootApplication

public class SftpApp implements CommandLineRunner {

@Autowired

private DefaultSftpSessionFactory sftpSessionFactory;

SpringApplication.run(SftpApp.class, args);

@Override

public void run(String... args) throws Exception {

SftpRemoteFileTemplate template = new SftpRemoteFileTemplate(sftpSessionFactory);

template.send("本地文件.txt", "/remote/path/");

适合场景🏢：

- 需要断点续传、批量处理等复杂逻辑。

- 和其他Spring组件（如消息队列）无缝集成。

三、性能优化与常见翻车现场

1. 连接池：别让每次上传都“重新相亲”

频繁创建SFTP会话会拖慢速度，推荐使用`JSch`+连接池（如HikariCP魔改版），或者直接用Spring Integration的缓存机制。

2. 大文件传输：小心内存爆炸💥

- JSch方案：用`ChannelSftp

put(InputStream, String)`流式上传。

- Commons VFS：默认就是流式处理，稳得很。

3. 权限问题：Linux服务器的傲娇日常

上传失败？先用SSH手动测试目录权限：

```bash

chmod -R 777 /upload

简单粗暴版（生产环境慎用）

四、：选哪个方案？看菜下饭！🍚

| 方案 | 优点 | 缺点 |

|--|--|--|

| JSch | 轻量级、可控性强 | 需要手动处理连接池 |

| Commons VFS | 多协议支持 | API略复杂 |

| Spring Integration | “Spring全家桶”生态加持 | 学习曲线陡峭 |

博主私货建议🗣️：

- 新手村玩家：先用JSch跑通流程。

- 懒人进阶版：Spring Integration yyds！

- **强迫症患者*

TAG:java上传sftp服务器吗,java ftp上传文件,java连接ftp上传文件,java文件上传服务器,sftp文件上传的java代码