当接到一个需要改多处、涉及不确定性、或超过半天工作量的任务时…

# 订单管理系统导出功能技术方案

一、需求梳理

• 筛选条件：日期区间（起止时间）+ 订单状态（多选/单选）
• 导出格式：Excel（.xlsx）
• 限制：单次最大 5 万条
• 交付形式：技术方案评审通过后再开发

二、技术选型

• 后端：沿用现有技术栈（如 Java + EasyExcel / Python + openpyxl/pandas，按团队现状定）
• 为何用 EasyExcel 类流式写入库：避免 POI 全量加载导致 OOM，5 万条量级可边查边写
• 前端：列表页加“导出”按钮 + 筛选条件透传

三、核心流程设计

1. 用户点击导出，前端提交筛选参数（startDate、endDate、status、分页游标）

2. 后端校验参数 + 权限（仅本人/本部门数据，按现有权限体系）

3. 数据量预检：先 count，超过 5 万条直接返回提示“请缩小筛选范围”，不执行导出

4. 流式查询（分批读取，如每批 1000~5000 条）→ 流式写入 Excel → 输出文件

5. 返回文件流或生成临时文件 + 下载链接

四、同步 vs 异步的选择

• 数据量小（预估 < 1万条，耗时数秒内）：同步导出，直接返回文件流，体验最好
• 数据量大（1万~5万条）：建议异步任务
• 创建导出任务，返回 taskId
• 后台线程池执行，完成后生成文件存对象存储/本地临时目录
• 前端轮询或消息通知，提供下载链接
• 文件设置过期时间（如 24 小时后清理），避免存储膨胀

五、关键设计点

• 导出字段：与业务方确认字段清单和顺序，列头用中文别名
• 大数据量防护：
• 查询必须走索引（订单表的 create_time + status 组合索引）
• 禁止深分页 offset，用 id 游标分批
• 重复导出控制：同一用户短时间多次点击做防抖/限流
• 审计日志：记录谁在什么时间用哪些条件导出了多少条，便于安全追溯
• 敏感字段：如手机号等是否脱敏导出，需业务方确认

六、异常与边界

• 参数缺失/日期非法：统一参数校验与错误码
• 导出过程中失败：异步任务标记失败，支持重试；同步导出返回错误提示
• 并发导出：限制单用户同时进行的导出任务数（如 1~2 个）

七、工作量预估与排期

• 方案评审 + 字段确认：0.5~1 天
• 后端开发（含异步任务框架）：2~4 天
• 前端联调 + 测试：1~2 天
• 合计约 1 周内可交付

八、待确认事项

1. 导出字段清单及是否需要脱敏

2. 大数据量场景是否接受异步导出

3. 文件保留时长与存储位置（对象存储 or 本地）