EPPlus结合.NET Core 6使用R1C1公式触发XML公式移除报错

排查步骤 #

• 验证R1C1公式语法
  先把Excel切换到R1C1引用模式（文件→选项→公式→勾选「R1C1引用样式」），手动输入你在代码里用的公式，看是否能正常计算。如果Excel里直接报错，说明公式本身语法有问题。
• 检查EPPlus公式属性使用
  确认代码中是用FormulaR1C1属性设置公式，而不是Formula属性——后者是用于A1格式的公式，混用会导致Excel无法解析R1C1语法。
• 导出Worksheet XML排查
  输出目标工作表的XML内容，查看公式节点的原始内容，检查是否存在语法错误、无效引用或不符合OOXML规范的内容：

  Console.WriteLine(worksheet.WorksheetXml.InnerXml);
  

• 检查EPPlus版本兼容性
  .NET Core 6需要搭配EPPlus 5.x及以上版本，旧版本（如4.x）存在.NET Core兼容问题，可能导致公式写入异常。

解决方法 #

• 正确设置R1C1公式
  必须使用FormulaR1C1属性赋值，示例：

  // 正确：用FormulaR1C1设置R1C1格式公式
  worksheet.Cells["C3"].FormulaR1C1 = "=SUM(R[-2]C:R[-1]C)";
  // 错误：用Formula属性写R1C1公式，会导致Excel解析失败
  // worksheet.Cells["C3"].Formula = "=SUM(R[-2]C:R[-1]C)";
  

• 避免无效相对引用
  比如单元格在第一行时使用R[-1]C会引用不存在的行，这种情况要调整引用范围，或改用绝对引用（如R1C1）。
• 启用EPPlus公式验证
  保存前调用workbook.Validate()，捕获公式语法或引用错误：

  try
  {
      workbook.Validate();
      workbook.SaveAs("result.xlsx");
  }
  catch (Exception ex)
  {
      Console.WriteLine($"公式错误：{ex.Message}");
  }
  

• 强制公式计算
  保存前调用workbook.Calculate()，确保公式结果被计算并写入，避免打开Excel时单元格为空：

  workbook.Calculate();
  workbook.SaveAs("result.xlsx");
  

日志排查方案 #

• 启用EPPlus内置日志
  EPPlus 5.x及以上支持日志记录，通过以下方式获取操作日志：

  var package = new ExcelPackage();
  package.Log = new List<string>();
  
  // 执行工作表创建、公式设置等操作
  
  foreach (var logEntry in package.Log)
  {
      Console.WriteLine($"EPPlus日志：{logEntry}");
  }
  

• 查看Excel修复报告
  打开报错的Excel文件时，会弹出修复提示，点击「查看修复详情」可获取具体的公式错误位置和原因；也可查看Excel生成的修复后文件，里面包含完整的修复日志。

内容的提问来源于stack exchange，提问作者nittin aggarwal