files.copy() 不能直接操作远程地址，但可高效实现本地与远程流的拷贝：将本地文件转为inputstream传给远程outputstream，或把远程inputstream传给本地path。
Files.copy() 本身不支持直接与远程输入流（如 HTTP 响应流、SFTP 输入流）或输出流交互，它只工作在 Path（本地文件系统路径）和 InputStream/OutputStream 之间。但你可以通过组合使用它与远程流来实现“本地 ↔ 远程”的高效拷贝——关键在于：**把远程流当作普通流传入/传出 Files.copy()，而非试图让 Files.copy() 直接操作远程地址**。
✅ 本地文件 → 远程输出流（如上传到 HTTP 服务、SFTP）
适用场景：把本地一个大文件（如日志、图片）上传到远程 API 或 SFTP 服务器。
做法是：用 Files.newInputStream(localPath) 获取本地输入流，再传给远程客户端的写入方法（例如 HttpURLConnection.getOutputStream() 或 SftpChannel.put()）。但注意：Files.copy() 可以直接把本地文件流复制到任意 OutputStream，包括远程连接打开的输出流。
示例（上传到 HTTP 接口）：
URL url = new URL("https://api.example.com/upload");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setDoOutput(true);
conn.setRequestProperty("Content-Type", "application/octet-stream");
try (InputStream fis = Files.newInputStream(Paths.get("/local/data.zip"));
OutputStream os = conn.getOutputStream()) {
Files.copy(fis, os); // 高效零拷贝缓冲（内部用堆外缓冲 + transferTo 如果可用）
}
int responseCode = conn.getResponseCode(); // 检查上传结果
- ✅ 不需要手动读写循环，Files.copy() 自动选择最优方式（JDK 9+ 优先用
FileChannel.transferTo） - ⚠️ 确保远程 OutputStream 支持阻塞写入且未关闭；HTTP 上传需提前设置好请求头和状态
- ⚠️ 大文件建议配合
conn.setChunkedStreamingMode(0)或设置Content-Length（若已知大小）
✅ 远程输入流 → 本地文件（如下载 HTTP/SFTP 文件）
适用场景：从远程 URL 或 SFTP 下载文件并保存到磁盘。
做法：把远程打开的 InputStream（如 HttpURLConnection.getInputStream() 或 SftpChannel.get()）作为源，本地 Path 作为目标，调用 Files.copy(InputStream, Path, ...)。
示例（下载 HTTP 文件）：
URL url = new URL("https://example.com/report.pdf");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
try (InputStream is = conn.getInputStream();
OutputStream fos = Files.newOutputStream(Paths.get("/tmp/report.pdf"))) {
Files.copy(is, fos); // 同样自动启用高效传输路径
}
- ✅ 支持断点续传？需自行处理 Range 请求 +
StandardOpenOption.APPEND，Files.copy() 本身不管理 HTTP 协议逻辑 - ✅ 可加
COPY_ATTRIBUTES标志（对远程流无效），但通常忽略 - ⚠️ 必须确保远程流可重复读（一般不可）、支持 mark/reset（非必须，Files.copy 不依赖）；实际中只要流能顺序读完即可
⚠️ 注意事项与性能要点
-
缓冲不是必须手动加：Files.copy() 内部已使用 8KB+ 缓冲区，且 JDK 11+ 在支持时会直接调用
transferTo实现内核级零拷贝（Linux: sendfile, macOS: fcopyfile） -
不要包装流做额外缓冲：比如把
InputStream包成BufferedInputStream通常无益，甚至可能降低 transferTo 路径触发概率 -
异常处理要覆盖流生命周期：务必用 try-with-resources 确保远程连接和本地流都释放；HTTP 连接记得调用
conn.disconnect()（或复用连接池） -
超时控制靠远程客户端：Files.copy() 本身不处理网络超时，需在建立连接时设置
conn.setConnectTimeout()和setReadTimeout()
❌ 常见误区
- 误以为
Files.copy(Path, Path)能跨网络：它只在本地文件系统间工作（即使路径是 UNC 或 NFS 挂载，也依赖 OS 层支持） - 试图传入
URL.openStream()并期望自动重定向/认证：需手动处理 HTTP 重定向、Cookie、Bearer Token 等，Files.copy() 只管字节搬运 - 用
Files.copy(InputStream, OutputStream)后又去 close 流：会导致 double-close 异常，务必交给 try-with-resources 管理
本质上，Files.copy() 是一个“流管道加速器”，不是网络客户端。把它用在远程场景的核心逻辑就是：你负责建立和管理远程连接与流，它负责把字节高效地从一端泵到另一端。
