唯一安全可部署的WebAPI导出方式是用HttpResponseMessage返回application/vnd.openxmlformats-officedocument.spreadsheetml.sheet流；Interop因强制STA线程、依赖桌面会话且在IIS/Linux必然失败，绝不能用于WebAPI。
直接用 HttpResponseMessage 返回 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet 类型的流，是唯一安全、可部署、不依赖 Office 安装的 WebAPI 导出方式。COM 自动化（Microsoft.Office.Interop.Excel）在 IIS 或 Linux 上必然失败，且存在进程残留和线程套间（STA）问题，绝不能用于 WebAPI 场景。
为什么不能用 Interop 在 WebAPI 中导出 Excel
WebAPI 运行在后台工作线程（MTA），而 Microsoft.Office.Interop.Excel 强制要求 STA 线程 + 桌面交互式会话 —— IIS 应用池默认无桌面会话，Linux 更不可能有 Excel 进程。常见报错包括：Retrieving the COM class factory for component with CLSID {00024500-0000-0000-C000-000000000046} failed、Server execution failed、Access is denied。即使本地调试侥幸成功，上线后必崩。
- Interop 会启动隐藏 Excel 进程，无法可靠释放，IIS 长期运行后内存泄漏+句柄耗尽
- 每个请求都新建 Excel 实例，CPU 和内存开销呈线性增长，不满足高并发场景
- 生成的 .xls 文件不支持大数据量（65536 行限制），且无法设置样式/公式/多 sheet
必须用 NPOI 或 EPPlus 实现流式导出
NPOI（推荐）和 EPPlus 都基于 Open XML 标准，纯托管代码，无外部依赖，支持 .NET 6+、跨平台（Windows/Linux/macOS），且能真正“流式”写入 —— 即边构建边写入 MemoryStream，避免全量加载到内存。EPPlus 从 v6 起需商业许可证（免费版限 10 万单元格），NPOI 完全免费且社区活跃。
- 使用
HSSFWorkbook（.xls）或XSSFWorkbook（.xlsx）：后者是 WebAPI 导出首选，兼容性好、容量大、支持样式 - 关键技巧：用
using var stream = new MemoryStream()包裹工作簿写入，再用stream.Position = 0重置指针供返回 - Oracle 数据读取务必用
OracleCommand.ExecuteReader(CommandBehavior.Sequential)启用顺序读取，避免 DataSet 全量缓存
WebAPI Controller 中导出的核心代码结构
不要把 DataTable 全部加载进内存再转 Excel；要逐行读取 Oracle 数据并实时写入 XSSFSheet，配合自动 flush（NPOI 内部已优化）。以下是最简可行骨架：
public async Task<IActionResult> ExportOracleToExcel()
{
var stream = new MemoryStream();
using (var workbook = new XSSFWorkbook())
{
var sheet = workbook.CreateSheet("Data");
var headerRow = sheet.CreateRow(0);
// 假设你已从 OracleCommand 获取列名
foreach (var col in columnNames) headerRow.CreateCell(colIndex++).SetCellValue(col);
int rowIndex = 1;
await using (var reader = await oracleCommand.ExecuteReaderAsync(CommandBehavior.Sequential))
{
while (await reader.ReadAsync())
{
var row = sheet.CreateRow(rowIndex++);
for (int i = 0; i < reader.FieldCount; i++)
{
var cell = row.CreateCell(i);
var val = reader.GetValue(i);
if (val != DBNull.Value) cell.SetCellValue(val.ToString());
}
}
}
workbook.Write(stream);
stream.Position = 0;
}
return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "export.xlsx");
}
- 注意：
workbook.Write(stream)必须在using块内完成，否则流可能未刷新 - 若字段含日期/数字，需调用
cell.SetCellType(CellType.Numeric)并配合CellStyle设置格式，否则 Excel 会当文本处理 - 超大数据量（>10 万行）建议分批写入 + 使用
sheet.ForceFormulaRecalculation = true控制计算行为
容易被忽略的 Oracle 连接与字符集细节
Oracle 默认使用数据库字符集（如 AL32UTF8），但 NPOI 写入时对中文无影响；真正易出错的是连接字符串中的 Unicode=true 设置 —— 若漏掉，reader.GetString() 可能返回乱码或截断。必须显式启用：
Data Source=...;User Id=...;Password=...;Unicode=True;- 若用 Oracle.ManagedDataAccess，该参数默认为 true；若用旧版 System.Data.OracleClient（已弃用），必须手动加
- 导出文件名含中文时，HTTP 响应头需用
FileName*=UTF-8''export%E4%BE%8B.xlsx编码，否则 IE/Edge 下乱码
