【实用应用】轻量级Web 数据导出工具，SQL 结果集流式导出 CSV（java作后端）
站内本项目的源代码和程序资源下载，点击进入下载页面
第一章：概述
1.1 项目定位
本项目是一个轻量级 Web 数据导出工具，核心解决一个常见但棘手的问题：如何安全、高效地将数据库查询结果导出为 CSV 文件，而不引发内存溢出（OOM）。
传统做法中，开发者常一次性将查询结果加载到内存（如List<Map>），再写入文件。当数据量达到百万级时，JVM 堆内存会迅速耗尽。本项目采用流式处理（Streaming）架构，实现"边读边写"，将内存占用控制在极低水平，理论上可支持无限量数据导出。
1.2 核心特性一览
| 特性 | 说明 |
|---|---|
| 多数据库兼容 | 支持 MySQL、Oracle、PostgreSQL 三大主流关系型数据库 |
| 流式导出 | 基于 JDBC 游标与 ResultSet 流式读取，配合 OpenCSV 流式写入，内存占用恒定 |
| 可配置化 | 列分隔符、表头开关、字符编码、最大行数限制、查询超时等均可动态调整 |
| 连接池管理 | 基于 HikariCP 实现连接复用，避免频繁创建/销毁连接的开销 |
| 前端交互 | Thymeleaf 模板引擎 + 简洁 HTML/CSS，提供可视化配置界面 |
| 连接验证 | /test-connection端点真实尝试建连，杜绝"假成功" |
第二章：技术架构与选型 rationale
2.1 技术栈全景
2.2 关键技术选型理由
Java 17 + Spring Boot 2.7.18
- Java 17 作为 LTS 版本，提供稳定的性能与长期支持
- Spring Boot 2.7.x 是 2.x 线的最后一个维护版本，成熟稳定，Embedded Tomcat 内嵌部署，开箱即用
HikariCP
- 号称"最快的 JDBC 连接池"，相比 Druid、C3P0 等，连接获取速度更快，内存占用更小
- 自动管理连接的创建、复用、回收，支持动态配置参数
OpenCSV
- 成熟的 CSV 处理库，支持流式写入（
CSVWriter），可直接对接OutputStreamWriter - 自动处理特殊字符转义（如逗号、换行符、引号），避免生成格式错误的 CSV
Thymeleaf
- 与 Spring Boot 深度集成，无需前后端分离即可实现服务端渲染
- 适合此类工具型、配置型页面的快速开发
第三章：核心原理详解
3.1 流式导出
传统模式的内存陷阱
假设查询返回 100 万行数据，每行 10 列，平均每行 1KB：
- 全量加载到内存：
1,000,000 × 1KB ≈ 1GB - 加上 JVM 对象头、集合结构开销，实际占用可能达到2~3GB
- 并发多个请求时，极易触发
OutOfMemoryError
流式模式的优势
流式导出的核心思想是生产者-消费者模式：
- 生产者：JDBC 驱动通过数据库游标（Cursor）逐行读取数据
- 消费者：OpenCSV 逐行写入 HTTP 响应流
- 中间状态：同一时间内存中仅保留当前行数据，内存占用恒定在MB 级别