CsvHelper升级到27.2.1后自定义映射写入CSV失效如何解决

核心原因 #

CsvHelper从v21版本开始重构了上下文逻辑，每个CsvWriter/CsvReader实例会独立初始化自带的CsvContext，不再共享全局配置下的映射规则。你提前注册到外部_context的自定义映射不会自动同步到新创建的CsvWriter内部的Context中，因此写入时会触发默认的自动映射逻辑，带出未配置的created字段。

修复方案 #

场景1：每次写入单独注册映射 #

直接在创建CsvWriter后，将自定义映射注册到当前writer自带的Context中即可，修改后的代码如下：

using (StreamWriter _stream = new StreamWriter(_fileLocation))
{
  using (CsvWriter _csvWriter = new CsvWriter(_stream, CsvContext.Configuration))
  {
      // 新增：将自定义映射注册到当前写入器的上下文
      _csvWriter.Context.RegisterClassMap(CreateMap());
      _csvWriter.WriteRecords(items);
      _csvWriter.Flush();
  }
}

场景2：复用提前注册好映射的全局Context #

如果你已经提前将所有自定义映射注册到了全局_context实例，可以直接调用支持传入Context的构造函数创建CsvWriter，无需重复注册：

using (StreamWriter _stream = new StreamWriter(_fileLocation))
{
  // 直接传入已完成映射注册的全局Context实例
  using (CsvWriter _csvWriter = new CsvWriter(_stream, _context))
  {
      _csvWriter.WriteRecords(items);
      _csvWriter.Flush();
  }
}

可选兜底配置 #

如果仍出现自动映射额外字段的问题，可以在创建CsvConfiguration时显式关闭未映射字段的自动映射逻辑：

var config = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    // 仅保留ClassMap中显式定义的字段
    ShouldMapMember = member => member.IsMapped
};

内容的提问来源于stack exchange，提问作者Dennis.Verweij