使用openpyxl合并单元格时出现Excel文件损坏问题求助

生成的sample.xlsx文件打开时，Excel提示：“发现'filename.xlsx'中的部分内容存在问题。是否尝试尽可能恢复内容？若信任此工作簿来源，请点击是”，恢复后显示“已移除记录：来自/xl/worksheets/sheet0.xml部分的合并单元格”。已确认所有单元格都填充了空字符串（无None值），但问题仍未解决。

相关处理代码如下：

def merge_cells_if_value(cell, cell_row, sheet, row_with_names_index, nested_row_index):

    pre_up_cell_row = cell_row - 1
    cell_column_letter = COLUMN_LETTERS[cell.column - 1]

    pre_up_cell_coords = f'{cell_column_letter}{pre_up_cell_row}'
    cur_cell_coords = f'{cell_column_letter}{cell.row}'

    if sheet[pre_up_cell_coords].value is not None or pre_up_cell_row == nested_row_index:
        if pre_up_cell_row != row_with_names_index:
            if sheet[pre_up_cell_coords].value is None:
                sheet[f'{pre_up_cell_coords}'] = ''

            print(cell, pre_up_cell_coords, sheet[pre_up_cell_coords].value, nested_row_index)
            sheet.merge_cells(
                f'{pre_up_cell_coords}:'
                f'{cur_cell_coords}'
            )
            target_cell = sheet[f'{pre_up_cell_coords}']
        else:
            target_cell = cell

        make_cell_alignment(target_cell, wrap_text=True)
        make_cell_border(target_cell)

    else:
        merge_cells_if_value(cell, pre_up_cell_row, sheet, row_with_names_index, nested_row_index)

可能的问题及解决方法 #

• 无效合并范围或重复合并：递归过程中可能出现单个单元格合并（比如cell_row=1时pre_up_cell_row=0，导致无效行引用），或者多次合并同一区域，引发Excel XML结构异常。需在递归中加入行号有效性检查，避免引用小于1的行。
• 列字母拼接错误：依赖COLUMN_LETTERS数组转换列号到字母，当列数超过26时（如AA列）会出现索引越界，导致坐标拼接错误。建议直接使用openpyxl的行列索引参数调用merge_cells，避免列字母转换。
• 递归终止条件缺失：当前递归仅以上方单元格有值或达到指定行作为终止条件，未处理行号小于1的情况，会导致生成无效的单元格引用，破坏Excel文件结构。
• 重叠合并冲突：递归逐行合并可能导致重叠的合并区域，Excel不允许交叉的合并单元格，需确保合并区域互不重叠。

修改后的示例代码 #

def merge_cells_if_value(cell, cell_row, sheet, row_with_names_index, nested_row_index):
    # 终止条件：行号小于1时停止递归
    if cell_row < 1:
        return
    
    pre_up_cell_row = cell_row - 1
    current_col = cell.column

    # 检查上一行是否有效
    if pre_up_cell_row < 1:
        target_cell = cell
        make_cell_alignment(target_cell, wrap_text=True)
        make_cell_border(target_cell)
        return

    pre_up_cell = sheet.cell(row=pre_up_cell_row, column=current_col)
    # 确保单元格值不为None
    if pre_up_cell.value is None:
        pre_up_cell.value = ''

    if pre_up_cell.value != '' or pre_up_cell_row == nested_row_index:
        if pre_up_cell_row != row_with_names_index:
            # 避免单个单元格合并
            if pre_up_cell_row != cell_row:
                sheet.merge_cells(
                    start_row=pre_up_cell_row,
                    start_column=current_col,
                    end_row=cell_row,
                    end_column=current_col
                )
            target_cell = pre_up_cell
        else:
            target_cell = cell

        make_cell_alignment(target_cell, wrap_text=True)
        make_cell_border(target_cell)
    else:
        merge_cells_if_value(cell, pre_up_cell_row, sheet, row_with_names_index, nested_row_index)

内容的提问来源于stack exchange，提问作者Steep 27