生产服务器上OpenXML生成的Excel文件损坏报错排查

问题现象 #

使用OpenXML生成的Excel文件打开时提示“我们发现Excel中的某些内容存在问题”，Excel修复日志显示“已修复记录：来自/xl/worksheets/sheet1.xml部分的视图”，手动解压xlsx文件未发现明显结构异常。

核心问题定位 #

1. Worksheet缺失必要的视图节点 #

OpenXML规范要求Worksheet必须包含SheetViews节点（即使是默认视图配置），否则Excel会判定文档结构不完整，触发修复提示。现有代码仅写入Worksheet -> SheetData层级，完全遗漏了视图相关节点。

2. 样式表中Fill索引引用错误 #

默认Excel样式表的Fills集合初始包含2个元素（无填充、灰色填充），新增自定义Fill后索引应为1，但代码中Header对应的CellFormat设置FillId = 2，引用了不存在的Fill资源，间接引发文档校验失败。

3. 日期格式CellFormat的FormatId设置无效 #

日期格式的CellFormat中FormatId = 1是非法值，FormatId对应差异格式的索引，默认应设为0。

修复代码 #

修复Worksheet生成逻辑（补全视图节点） #

在写入SheetData前添加默认SheetViews节点：

using (var writer = OpenXmlWriter.Create(worksheetPart))
{
    writer.WriteStartElement(new Worksheet());
    // 新增默认SheetViews节点，解决视图修复问题
    writer.WriteStartElement(new SheetViews());
    writer.WriteElement(new SheetView { TabSelected = true, WorkbookViewId = 0 });
    writer.WriteEndElement(); // 关闭SheetViews标签

    writer.WriteStartElement(new SheetData());
    // 原有表头、数据行写入逻辑保持不变...
}

修复样式表Fill索引错误 #

将Header的CellFormat中FillId从2改为1：

cf = new CellFormat();// Header format is defined as StyleINdex = 2
cf.NumberFormatId = nf.NumberFormatId;
cf.FontId = 0;
cf.FillId = 1; // 修正为新增Fill的正确索引
cf.ApplyFill = true;
cf.BorderId = 0;
cf.FormatId = 0;
cf.ApplyNumberFormat = true;
cfs.Append(cf);

修复日期格式CellFormat的FormatId错误 #

将日期格式CellFormat的FormatId从1改为0：

var cf = new CellFormat();// Date time format is defined as StyleIndex = 1
cf.NumberFormatId = nf.NumberFormatId;
cf.FontId = 0;
cf.FillId = 0;
cf.BorderId = 0;
cf.FormatId = 0; // 修正为合法默认值
cf.ApplyNumberFormat = true;
cfs.Append(cf);

额外优化建议 #

• 使用OpenXML SDK自带的OpenXmlValidator工具提前校验文档结构，避免隐性错误：

var validator = new OpenXmlValidator();
foreach (var error in validator.Validate(spreadSheet))
{
    Console.WriteLine($"校验错误：{error.Description}");
}

• 确保FormatoCampo方法返回的StyleIndex始终在CellFormats集合的有效索引范围内
• 检查共享字符串字典的维护逻辑，避免索引不匹配导致的内容错误

内容的提问来源于stack exchange，提问作者Gabriel Manzini