Excel百万数据导出最佳实战指南

(

    @"SELECT Id, Name, CreateTime 
    FROM BigTable 
    WHERE Id > @Checkpoint 
    ORDER BY Id 
    OFFSET 0 ROWS 
    FETCH NEXT @Size ROWS ONLY 
    OPTION (RECOMPILE)", // 强制重新编译执行计划
    new { checkpoint, size });

}

### 3. 异常处理增强
```csharp
try
{
    await ExportDataAsync();
}
catch (MiniExcelException ex) when (ex.ErrorCode == "DISK_FULL")
{
    await CleanTempFilesAsync();
    await RetryExportAsync();
}
catch (SqlException ex) when (ex.Number == 1205) // 死锁重试
{
    await Task.Delay(1000);
    await RetryExportAsync();
}
finally
{
    _semaphore.Release(); // 释放信号量
}

七、最佳实践总结

‌1、数据分页策略‌

• 使用有序 ID 分页避免 OFFSET 性能衰减

// 优化分页查询
var lastId = 0;
while (true)
{
    var data = Query($"SELECT * FROM Table WHERE Id > {lastId} ORDER BY Id FETCH NEXT 50000 ROWS ONLY");
    if (!data.Any()) break;
    lastId = data.Last().Id;
}

‌2、内存控制三位一体‌

• 启用服务器 GC 模式
• 配置共享数组池
• 使用对象池复用 DTO 3‌、异常处理金字塔

try {
    // 核心逻辑
} 
catch (IOException ex) when (ex.Message.Contains("磁盘空间")) {
    // 磁盘异常处理
}
catch (SqlException ex) when (ex.Number == 1205) {
    // 数据库死锁处理
}
catch (Exception ex) {
    // 通用异常处理
}

八、避坑指南

常见陷阱

‌EPPlus的内存泄漏

// 错误示例：未释放ExcelPackage
var pkg = new ExcelPackage(); // 必须包裹在using中
pkg.SaveAs("leak.xlsx");
// 正确用法
using (var pkg = new ExcelPackage())
{
    // 操作代码
}

NPOI的文件锁定

// 错误示例：未正确释放资源
var workbook = new XSSFWorkbook();
// 正确用法
using (var fs = new FileStream("data.xlsx", FileMode.Create))
{
    workbook.Write(fs);
}

异常处理最佳实践

try
{
    await ExportAsync();
}
catch (MiniExcelException ex) when (ex.ErrorCode == "DISK_FULL")
{
    _logger.LogError("磁盘空间不足: {Message}", ex.Message);
    await CleanTempFilesAsync();
    throw new UserFriendlyException("导出失败，请联系管理员");
}
catch (DbException ex) when (ex.IsTransient)
{
    _logger.LogWarning("数据库暂时性错误，尝试重试");
    await Task.Delay(1000);
    await RetryExportAsync();
}
finally
{
    _exportSemaphore.Release();
}

九、典型场景建议‌

1. ‌金融报表‌ → EPPlus（复杂公式+图表）
2. ‌日志导出‌ → MiniExcel（千万级流式处理）
3. ‌旧系统迁移‌ → NPOI（xls兼容）
4. ‌动态模板‌ → MiniExcel模板引擎 * * * 通过合理的方案选择和优化配置，可实现：

• ‌内存消耗‌降低 80% 以上
• ‌导出速度‌提升 3-5 倍
• ‌系统稳定性‌显著增强