使用Excel JS插入行后合并单元格报错：无法合并已合并单元格

核心问题分析 #

报错的主要原因有两个：

1. 插入行顺序错误：连续两次在同一位置插入行，导致新增两行的位置逻辑混乱，且可能继承了模板中原行的合并设置；
2. 模板预合并冲突：原Excel模板的第16行（插入位置附近）可能存在预先合并的单元格，插入新行后，新行自动继承了合并状态，触发二次合并报错。

解决方案 #

1. 调整插入行逻辑 #

将两次插入行的位置改为连续的row和row+1，确保新增两行是相邻的，避免位置混乱。

2. 先解除合并再合并 #

在执行合并操作前，先尝试解除目标单元格的合并状态（即使没有合并也不会报错），避免冲突。

3. 修正数据赋值位置 #

确保数据赋值对应到正确的新增行。

修改后的完整代码 #

const filepath = path.join(__dirname, "./excel/template.xlsx");
const workbook = new Excel.Workbook();
workbook.xlsx.readFile(filepath).then(function () {
  var worksheet = workbook.getWorksheet("Sheet1");

  let row = 16;
  let count = 1;
  if (fitupData.length) {
    var borderStyles = {
      top: { style: "thin" },
      left: { style: "thin" },
      bottom: { style: "thin" },
      right: { style: "thin" },
    };

    fitupData.forEach((item) => {
      // 调整插入顺序：先插入第一行，再在其下方插入第二行，确保两行连续
      let firstRow = worksheet.insertRow(row, []);
      let secondRow = worksheet.insertRow(row + 1, []);

      firstRow.border = borderStyles;
      firstRow.alignment = { horizontal: "center" };

      // 第一行的J、K列赋值（对应row行）
      worksheet.getCell(`J${row}`).value = item.A2;
      worksheet.getCell(`K${row}`).value = item.B2;

      // 第二行赋值（对应row+1行）
      secondRow.values = [
        count,
        item.v1,
        item.v2,
        item.v3,
        item.v4,
        item.v5,
        item.v6,
        item.v7,
        item.v8,
        item.A1,
        item.B1,
        "Accepted",
        "-",
        item.v11,
        "-",
        "-",
        item.v12,
      ];

      // 合并单元格：先解除可能存在的合并，再执行合并
      for (let i = 65; i <= 81; i++) {
        // A到Q列
        let col = String.fromCharCode(i);
        if (["J", "K"].includes(col)) continue;
        const mergeRange = `${col}${row}:${col}${row + 1}`;
        // 先尝试解除合并，忽略无合并时的错误
        try {
          worksheet.unMergeCells(mergeRange);
        } catch (e) {}
        // 执行合并
        worksheet.mergeCells(mergeRange);
      }

      row = row + 2;
      count++;
    });
  }

  const fileName = path.join(__dirname, "./excel/Report.xlsx");
  workbook.xlsx
    .writeFile(fileName)
    .then(() => {
      resolve(fileName);
    })
    .catch((err) => {
      console.log(err);
    });
});

额外检查点 #

如果修改后仍报错，请检查原Excel模板：

• 确认第15行、16行及附近区域没有预先合并的单元格；
• 若有预合并，可先在模板中取消这些合并，或在代码开头先解除模板对应区域的合并。

内容的提问来源于stack exchange，提问作者Shafeeque OM