Java下载文件的核心是流式读写与协议细节处理：基础用URLConnection+FileOutputStream并设超时；Web场景需设置Content-Disposition等响应头；进阶支持断点续传、进度监听；避坑包括中文名编码、分块读写及慎用Files.copy。
Java 下载文件的核心思路是：从远程 URL 读取数据流，再写入本地文件。关键在于正确处理输入输出流、设置响应头（如果是 Web 场景）、避免内存溢出，并注意中文文件名、重定向、超时等常见问题。
基础方式：用 URLConnection + FileOutputStream
适合简单场景，如后台定时下载或命令行工具：
- 创建 URL 对象，调用 openConnection() 获取连接
- 可选：设置超时（setConnectTimeout / setReadTimeout）、User-Agent
- 调用 getInputStream() 获取响应流，用 FileOutputStream 写入本地文件
- 务必使用 try-with-resources 或手动 close 流，防止资源泄漏
示例片段：
URL url = new URL("https://example.com/file.pdf");
try (InputStream in = url.openStream();
FileOutputStream out = new FileOutputStream("downloaded.pdf")) {
in.transferTo(out); // Java 9+ 推荐，简洁高效
}
Web 后端下载（如 Spring Boot）
用户点击链接触发下载，需让浏览器弹出保存对话框：
立即学习“Java免费学习笔记（深入）”；
- 设置响应头：Content-Disposition: attachment; filename="xxx.pdf"（注意 UTF-8 文件名需编码）
- 设置 Content-Type（如 application/pdf），未知类型可用 application/octet-stream
- 用 response.getOutputStream() 直接写入，避免 String 转码乱码
- Spring Boot 中推荐用 ResponseEntity
+ FileSystemResource，自动处理头和流
进阶需求：断点续传、大文件、进度监听
普通流复制不支持暂停/恢复。如需断点续传：
- 服务端需支持 Range 请求（返回 206 Partial Content）
- 客户端用 HttpURLConnection.setRequestProperty("Range", "bytes=1000-")
- 本地文件以 RandomAccessFile 打开，seek 到指定位置写入
- 进度监听可配合 BufferedInputStream 分块读取 + 回调计算百分比
实用建议与避坑
- 不要用 Files.copy(url.openStream(), path) 直接下载——无法设超时、无法处理重定向、无错误上下文
- 中文文件名在 HTTP 响应头中要用 URLEncoder.encode(name, "UTF-8") 并加 filename*=UTF-8''... 格式兼容主流浏览器
- 大文件（>100MB）务必分块读写（如 8KB buffer），禁用 ByteArrayOutputStream 全部加载进内存
- 生产环境建议用成熟库，如 Apache HttpClient（支持连接池、重试、Cookie 管理）或 OkHttp
基本上就这些。核心是流的正确打开、复制与关闭，再根据场景补足协议细节和用户体验细节。
