使用XLwings偶发整数变量对应range not found on sheet错误求解

错误触发核心原因 #

你遇到的COM错误码-2146827284是Excel COM接口返回的「范围无效」错误，偶发的核心诱因有3个：

• 第一是sht2Row值异常的偶发场景：你第一次调用sht2Row的时候值是合法的，但两次清空操作的间隔里，如果sht2Row被后续逻辑意外修改、或者你计算sht2Row的时候用了动态获取的方法（比如used_range.last_cell.row这类依赖工作表实时状态的属性），刚好第一次清空操作改变了工作表的used_range范围，导致第二次取sht2Row的时候获取到了小于起始行5的非法值，就会触发范围越界。这也解释了为什么第一次调用不报错、第二次报错，因为两次调用中间工作表状态已经变了。
• 第二是COM接口的异步时序问题：xlwings调用Excel是通过COM通信，你加的time.sleep(0.5)并不足以100%保证上一步清空操作已经被Excel完全执行完成，上一步的COM请求还在队列里的时候就发起新的范围操作，会偶发被Excel判定为范围无效。
• 第三是Excel后台进程的意外锁：如果系统后台有自动保存、文件同步类的进程（比如OneDrive同步、Excel自动恢复备份）刚好在你操作工作表的时刻占用了单元格范围，也会偶发触发COM接口的访问失败。

验证和修复方案 #

1. 先固定sht2Row的取值，不要用动态计算的属性重复取值：在所有清空操作执行前就把sht2Row赋值为固定整数，不要在两次清空操作中间重新计算该变量，操作前增加合法性校验：

# 在执行清空操作前就计算一次sht2Row，后续复用这个值
sht2Row = int(sht2.used_range.last_cell.row) # 此处替换为你原来的计算逻辑，确保只算一次
# 增加合法性校验
if sht2Row < 5:
    sht2Row = 5 # 也可根据需求抛出提示、跳过清空操作，避免范围越界

2. 替换sleep硬等待，改用COM操作异常捕获重试逻辑：

import pythoncom
import time
from pywintypes import com_error

def com_retry(func, retries=3, delay=1):
    for _ in range(retries):
        try:
            pythoncom.CoInitialize() # 确保线程COM环境初始化
            return func()
        except com_error as e:
            if e.args[0] == -2147352567:
                time.sleep(delay)
                continue
            raise
# 调用的时候包裹要执行的操作
com_retry(lambda: sht2.range((5,3),(sht2Row,10)).clear_contents())
com_retry(lambda: sht2.range((5,12),(sht2Row,16)).clear_contents())

3. 操作前暂时关闭Excel的自动保存、自动恢复功能，以及文件所在目录的实时同步功能，避免后台进程抢锁。

如果仍未解决，可以在计算sht2Row之后打印日志输出它的值，报错的时候核对值是否合法，就能快速定位是不是变量的问题。

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