.NET 6中使用CsvHelper 30.0.0异步写入CSV报错求助

问题原因 #

.NET 6及Azure Functions v4默认禁用了同步IO操作，你的代码存在两类触发问题的情况：

1. 第一种写法混用同步的WriteRecord和异步的NextRecordAsync，直接触发同步IO操作
2. 第二种写法虽用了WriteRecordsAsync，但直接操作Http响应流时，CsvHelper底层可能仍存在同步写入逻辑，或响应流的同步写入被Kestrel拦截

解决方案 #

方案1：修正全异步写法 #

将第一种写法中的同步方法替换为异步版本，确保所有IO操作均为异步：

foreach (var item in items)
{
    await csvWriter.WriteRecordAsync(item);
    await csvWriter.NextRecordAsync();
}

方案2：使用MemoryStream中转写入（推荐） #

避免直接操作Http响应流，先将CSV内容写入MemoryStream，再返回流结果，彻底绕过同步IO限制：

// 获取待导出的DTO列表
var items = GetExportItems();

// 用MemoryStream中转存储CSV内容
using var memoryStream = new MemoryStream();
using var streamWriter = new StreamWriter(memoryStream, leaveOpen: true);
using var csvWriter = new CsvWriter(streamWriter, CultureInfo.InvariantCulture);

// 异步写入所有记录
await csvWriter.WriteRecordsAsync(items);
await streamWriter.FlushAsync();
// 将流指针重置到起始位置
memoryStream.Position = 0;

// 返回CSV文件结果
return new FileStreamResult(memoryStream, "text/csv")
{
    FileDownloadName = "export.csv"
};

方案3：临时允许同步IO（不推荐） #

若需快速验证问题，可临时开启同步IO支持，此方案会降低应用性能和稳定性，仅作过渡使用：

• In-Process模式：在Program.cs中添加配置

builder.Services.Configure<KestrelServerOptions>(options =>
{
    options.AllowSynchronousIO = true;
});
// 若部署到IIS，额外添加以下配置
builder.Services.Configure<IISServerOptions>(options =>
{
    options.AllowSynchronousIO = true;
});

• Isolated Worker模式：在host.json中添加配置

{
  "extensions": {
    "http": {
      "allowSynchronousIO": true
    }
  }
}

额外排查建议 #

• 部署到Azure后，修改host.json配置日志级别，将错误日志输出到Application Insights：

{
  "logging": {
    "applicationInsights": {
      "samplingSettings": {
        "isEnabled": true,
        "excludedTypes": "Request"
      }
    },
    "logLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore.Server.Kestrel": "Error"
    }
  }
}

• 确认CsvHelper对DTO的自动映射正常（简单DTO无需额外配置）

内容的提问来源于stack exchange，提问作者Jim Robson