Files.copy(Path, OutputStream)可直接将本地文件写入网络输出流，适用于HTTP响应、Socket或API请求体等场景，需确保源为Path、目标为OutputStream，且不自动刷新或关闭流。
files.copy 可以直接把本地文件内容写入网络输出流，比如 http 响应体、socket 输出、远程 api 请求体等。这种用法跳过内存缓冲或临时文件，减少资源占用，适合服务端响应静态资源、文件下载接口、代理转发等场景。
确认输入源和输出目标类型
要调用 Files.copy(Path, OutputStream)，必须满足：
- 源是 Path（来自 Paths.get()），不能是 File 或 InputStream
- 目标是 OutputStream 实例，例如 HttpServletResponse.getOutputStream()、OkHttpClient 的 RequestBody 中的 sink、或 Socket.getOutputStream()
- 不需要手动循环读写，也不用关心缓冲区大小——内部默认使用约 8KB 缓冲块高效传输
处理常见网络输出场景
不同网络上下文下，输出流生命周期管理方式不同：
- Servlet 响应流：直接传入 response.getOutputStream()，但需提前设置 Content-Type 和 Content-Length（可选）；注意不要在 try-with-resources 中关闭它，否则会中断响应
- OkHttp RequestBody：需自定义 RequestBody，重写 writeTo(OutputStream) 方法，在其中调用 Files.copy(sourcePath, output)
- Netty ChannelHandlerContext：可包装为 ChunkedStream 或直接 writeAndFlush(new DefaultFileRegion(fileChannel, 0, size))，但 Files.copy 不适用；此时建议改用 Files.newInputStream + 自定义写入逻辑
关键注意事项
这类操作看似简单，但容易踩坑：
- 源路径必须存在且可读：Files.copy 会在读取时抛出 NoSuchFileException 或 AccessDeniedException，需捕获并处理
- 输出流不可重复使用：一旦写入完成或异常中断，该 OutputStream 通常不能再用于其他写入（尤其 HTTP 响应流）
- 不自动刷新或关闭输出流：Files.copy 只负责写入数据，不调用 flush() 或 close()，由你确保后续流程正确结束
- 大文件需注意超时与内存：虽然无额外堆内存压力，但网络层可能因传输时间过长触发连接超时，建议配合 setSoTimeout 或 OkHttp 的 call.timeout()
一个 Servlet 下的实用示例
将磁盘上 /var/www/images/photo.jpg 直接写入 HTTP 响应：
Path imagePath = Paths.get("/var/www/images/photo.jpg");
response.setContentType("image/jpeg");
response.setContentLengthLong(Files.size(imagePath)); // 提前设长度利于浏览器进度条
try (OutputStream out = response.getOutputStream()) {
Files.copy(imagePath, out);
} catch (IOException e) {
response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
log.error("图片传输失败", e);
}
