如何修复Python xlwings切换Excel文件时出现的COM错误？

问题现象 #

• 首次运行代码可成功截取Excel指定区域并保存为图片，但切换其他.xlsx文件时抛出错误：com_error: (-2147417851, 'The server threw an exception。', None, None)
• 已尝试手动关闭任务管理器中的EXCEL.EXE进程、重启电脑，且替换app.quit()为app.kill()，均未解决问题
• 仅首次使用的.xlsx文件能正常运行，其他文件均报错

相关代码 #

from PIL import ImageGrab
import xlwings as xw
import time

excel_path = "file.xlsx"
sheet_name = "sheet1"
img_path = "test.png"

app = xw.App(visible=False, add_book=False)

wb = app.books.open(excel_path)
sheet = wb.sheets(sheet_name)

all = sheet.used_range
all.api.CopyPicture()

sheet.api.Paste()

pic = sheet.pictures[-1]
pic.api.Copy()

time.sleep(3)

img = ImageGrab.grabclipboard()
img.save(img_path)

pic.delete()
wb.save(excel_path)
wb.close()
app.quit()

报错信息 #

com_error: (-2147417851, 'The server threw an exception。', None, None)

解决方法 #

1. 排查Excel文件本身问题 #

• 检查文件完整性：手动打开报错的Excel文件，验证是否能正常编辑、复制粘贴区域；将文件另存为新的.xlsx格式后重新测试
• 解除文件保护：若工作表或工作簿设置了保护，会导致API操作失败，需先手动解除保护再运行代码

2. 优化COM对象生命周期管理 #

使用with上下文管理器自动管理Excel应用和工作簿的生命周期，避免手动释放资源的疏漏，同时明确CopyPicture的参数提升兼容性：

from PIL import ImageGrab
import xlwings as xw
import time

excel_path = "target_file.xlsx"
sheet_name = "sheet1"
img_path = "test.png"

# 用with自动处理资源释放
with xw.App(visible=False, add_book=False) as app:
    with app.books.open(excel_path) as wb:
        sheet = wb.sheets(sheet_name)
        used_range = sheet.used_range
        # 明确指定图片格式，避免默认参数兼容问题
        used_range.api.CopyPicture(Format=xw.constants.XlPictureFormat.xlBitmap)
        
        # 缩短等待时间，确保剪贴板操作完成
        time.sleep(0.5)
        sheet.api.Paste()
        
        pic = sheet.pictures[-1]
        pic.api.Copy()
        time.sleep(0.5)
        
        img = ImageGrab.grabclipboard()
        if img:
            img.save(img_path)
        else:
            raise ValueError("未从剪贴板获取到图片")
        
        pic.delete()
        wb.save()
# with块结束后自动执行wb.close()和app.quit()

3. 替换剪贴板操作（更稳定方案） #

避免依赖剪贴板的不确定性，直接使用xlwings的API导出区域为图片：

# 替代剪贴板的简化逻辑
used_range = sheet.used_range
used_range.api.CopyPicture(Format=xw.constants.XlPictureFormat.xlBitmap)
img = ImageGrab.grabclipboard()
if img:
    img.save(img_path)

4. 检查路径与权限 #

• 使用绝对路径指定Excel文件，避免相对路径导致的文件定位错误
• 确保目标文件未被杀毒软件、云同步工具等其他程序占用，关闭相关程序后再测试

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