pyautogui脚本while循环未执行 函数逻辑异常问题排查

基于pyautogui编写的自动化查询下载函数，在while循环内添加print(1)调试语句后，运行时循环完全未触发，无法定位故障点。
原代码如下：

def ConsultaDownload():
    VF = False
    VR = False
    consultar = pyautogui.locateOnScreen('ConsultaRetorno.PNG')
    pyautogui.click(consultar)
    sleep(0.5)
    while VF and VR == False:
        print(1)
        sleep(30)
        pyautogui.click(consultar)
        sleep(0.5)
        finalizado = pyautogui.locateOnScreen('Processamento_Finalizado.PNG')
        fRegistro = pyautogui.locateOnScreen('')  # processado e sem registro
        if finalizado:
            VF = True

        elif fRegistro:
            VR = True


ConsultaDownload()

循环不触发的核心原因是while条件判断逻辑书写错误：
Python中==运算符优先级高于and，因此写的while VF and VR == False实际等价于while VF and (VR == False)。初始状态下VF = False，整个条件表达式第一次判断就直接返回False，循环体自然一次都不会执行。

除此之外代码还存在3个会导致后续运行异常的隐藏问题：

• 识别无返回结果的截图路径传了空字符串''，pyautogui.locateOnScreen('')永远返回None，VR = True的分支永远无法触发
• 没有做图像匹配容错，默认精确匹配很容易因为屏幕缩放、UI色差导致识别失败
• 没有判断识别到的元素是否为None就直接点击，元素未加载完成时会直接抛错

import pyautogui
from time import sleep

def ConsultaDownload():
    VF = False
    VR = False
    consultar = pyautogui.locateOnScreen('ConsultaRetorno.PNG', confidence=0.9)
    # 首次点击前先判断按钮是否识别成功
    if consultar:
        pyautogui.click(consultar)
    sleep(0.5)
    # 修正循环条件：只要两个状态都为假就持续轮询
    while not VF and not VR:
        print(1)
        sleep(30)
        # 每次点击前重新识别按钮，避免页面刷新后位置变化
        consultar = pyautogui.locateOnScreen('ConsultaRetorno.PNG', confidence=0.9)
        if consultar:
            pyautogui.click(consultar)
        sleep(0.5)
        finalizado = pyautogui.locateOnScreen('Processamento_Finalizado.PNG', confidence=0.9)
        # 替换为实际存储的"无查询结果"截图文件名
        fRegistro = pyautogui.locateOnScreen('Sem_Registro.PNG', confidence=0.9)
        if finalizado:
            VF = True
        elif fRegistro:
            VR = True

ConsultaDownload()

• 使用confidence参数需要提前安装opencv-python依赖，执行pip install opencv-python即可
• 所有截图路径要和实际存储的文件名、路径完全一致，不要留空
• 轮询点击前建议每次重新识别按钮位置，避免页面加载后按钮位置偏移导致点击失效

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