OpenXML生成的XLSX文件需修复问题排查求助

问题背景 #

• 基于微软官方OpenXML文档实现的XLSX导出类，稳定运行多年，未修改代码及外部依赖库
• 一周前开始出现文件损坏提示，并非所有生成文件都会出问题
• 特定场景复现：在某模板的C24单元格写入任意共享字符串时，代码执行无报错，XML中共享字符串表（SharedString）已正确写入并引用，但Excel打开时提示需修复，修复后会删除该单元格文本，且C24之后的所有写入内容全部丢失
• 临时规避方案：将SharedString改为内部字符串可解决问题，但需找到根本原因

核心代码片段 #

主程序调用逻辑：

using (SpreadsheetDocument spreadSheet = SpreadsheetDocument.Open(Path.Combine(dialog.FileName, NomeFile), true))
{
    /*spreadSheet.WorkbookPart.Workbook.CalculationProperties.ForceFullCalculation = true;
    spreadSheet.WorkbookPart.Workbook.CalculationProperties.FullCalculationOnLoad = true;*/

    ExcelExportUtility.InsertText(spreadSheet, progetto.Titolo, "C", 8);
    ExcelExportUtility.InsertText(spreadSheet, docente.Docente, "C", 23);
}

核心InsertText方法：

public static void InsertText(SpreadsheetDocument spreadSheet, object text, string col, int row)
{
    CellValues type = GetExcelType(text);

    string index;
    if (type == CellValues.SharedString)
    {
        index = InsertSharedStringItem(spreadSheet, text.ToString()).ToString();
    }
    else
    {
        index = text.ToString().Replace(",", ".");
    }

    // Get worksheet
    WorkbookPart wbPart = spreadSheet.WorkbookPart;
    IEnumerable<Sheet> sheets = spreadSheet.WorkbookPart.Workbook.GetFirstChild<Sheets>().Elements<Sheet>();
    string sheetId = sheets.First().Id.Value;
    WorksheetPart wsPart = (WorksheetPart)wbPart.GetPartById(sheetId);

    // Insert cell into the worksheet.
    Cell cell = InsertCellInWorksheet(col, row, wsPart);
    cell.CellValue = new CellValue(index);
    cell.DataType = new EnumValue<CellValues>(type);

    wsPart.Worksheet.Save();
}

可能的原因分析 #

1. Excel版本自动更新的兼容性问题：用户端Excel可能自动推送了更新，对SharedString的校验逻辑变得更严格
2. 模板文件的隐藏损坏：特定单元格（如C24）可能存在隐藏的格式冲突、数据验证残留或绑定的无效公式
3. OpenXML写入时机问题：当前代码每次插入单元格就单独保存Worksheet，但SharedStringPart的保存滞后，导致Excel读取时索引不匹配
4. XML节点顺序敏感：部分Excel版本对Cell节点的子元素顺序（如CellValue和DataType的先后）有严格要求，代码中的顺序可能触发校验失败

根本解决方案 #

方案1：修复或重建模板文件 #

• 打开问题模板，清除目标单元格（如C24）的所有格式、数据验证、条件格式，甚至删除该单元格后重新插入
• 将模板另存为全新的XLSX文件，避免原有文件的隐藏损坏残留

方案2：调整SharedString与工作表的保存时机 #

将单单元格的保存改为统一批量保存，确保SharedString表与工作表数据同步：

// 修改主程序调用逻辑，统一保存
using (SpreadsheetDocument spreadSheet = SpreadsheetDocument.Open(Path.Combine(dialog.FileName, NomeFile), true))
{
    ExcelExportUtility.InsertText(spreadSheet, progetto.Titolo, "C", 8);
    ExcelExportUtility.InsertText(spreadSheet, docente.Docente, "C", 23);
    
    // 先保存共享字符串表，再保存工作簿
    if (spreadSheet.WorkbookPart.SharedStringTablePart != null)
    {
        spreadSheet.WorkbookPart.SharedStringTablePart.SharedStringTable.Save();
    }
    spreadSheet.WorkbookPart.Workbook.Save();
}

// 修改InsertText方法，移除单次保存
public static void InsertText(SpreadsheetDocument spreadSheet, object text, string col, int row)
{
    // ... 原有逻辑不变 ...
    
    cell.CellValue = new CellValue(index);
    cell.DataType = new EnumValue<CellValues>(type);

    // 移除该行，改为统一保存
    // wsPart.Worksheet.Save();
}

方案3：强制Cell节点的XML顺序 #

OpenXML规范要求Cell的子节点顺序为CellValue在前，DataType在后，若代码中顺序不符，可显式调整：

// 调整Cell属性设置顺序
cell.AppendChild(new CellValue(index));
cell.AppendChild(new EnumValue<CellValues>(type));

方案4：验证SharedString索引的正确性 #

在InsertSharedStringItem方法中，确保返回的索引是从0开始的连续整数，且SharedStringTable的元素数量与索引匹配，可添加日志打印验证：

public static int InsertSharedStringItem(SpreadsheetDocument spreadSheet, string text)
{
    // ... 原有逻辑 ...
    int index = sharedStringTable.Elements<SharedStringItem>().Count();
    // 打印日志验证索引与元素数量
    Debug.WriteLine($"SharedString索引：{index}，元素总数：{sharedStringTable.Elements<SharedStringItem>().Count()}");
    return index;
}

内容的提问来源于stack exchange，提问作者Enrico Agrusti