Gmail API是否会跳过验证码邮件？Python代码问题排查

问题说明 #

尝试通过Gmail API获取双因素认证（2FA）验证码邮件，但运行代码时无法捕获到这类邮件，疑问点：Gmail API是否会跳过这类邮件？代码存在哪些问题？

运行的代码 #

def getEmails(self):

    SCOPES = ['https://www.googleapis.com/auth/gmail.readonly']

    creds = None

    if os.path.exists(self.CREDENTIALS_PATH+'\\token.pickle'):

        with open(self.CREDENTIALS_PATH+'\\token.pickle', 'rb') as token:
            creds = pickle.load(token)

    if not creds or not creds.valid:
        if creds and creds.expired and creds.refresh_token:
            creds.refresh(Request())
        else:
            flow = InstalledAppFlow.from_client_secrets_file(self.CREDENTIALS_PATH+'\\credentials.json', SCOPES)
            creds = flow.run_local_server(port=0)

        with open(self.CREDENTIALS_PATH+'\\token.pickle', 'wb') as token:
            pickle.dump(creds, token)

    service = build('gmail', 'v1', credentials=creds)

    result = service.users().messages().list(userId='me').execute()

    result = service.users().messages().list(maxResults=5, userId='me').execute()
    messages = result.get('messages')

    for msg in messages:
        txt = service.users().messages().get(userId='me', id=msg['id']).execute()

        try:
            payload = txt['payload']
            headers = payload['headers']

            for d in headers:
                if d['name'] == 'Subject':
                    subject = d['value']
                if d['name'] == 'From':
                    sender = d['value']

            parts = payload.get('parts')[0]
            data = parts['body']['data']
            data = data.replace("-","+").replace("_","/")
            decoded_data = base64.b64decode(data)

            soup = BeautifulSoup(decoded_data , "lxml")
            body = soup.body()

            print("Subject: ", subject)
            print("From: ", sender)
            print("Message: ", body)
            print('\n')
        except:
            pass

解答 #

Gmail API不会跳过2FA验证码邮件 #

只要验证码邮件存在于你的Gmail账户中（无论在哪个标签文件夹），Gmail API都能正常访问到，不存在“跳过”这类邮件的机制。问题出在代码逻辑上。

代码存在的核心问题 #

1. 仅获取最近5封邮件，范围太窄
   代码通过maxResults=5只获取最近5封邮件，如果2FA验证码邮件不在这5封里，自然无法捕获。应该针对2FA邮件的特征（比如特定发件人、包含“验证码”的主题）用q参数过滤，而不是盲目取最近的邮件。

2. 异常处理过于宽泛，隐藏错误
   直接用except:捕获所有异常并pass，导致代码运行出错时完全看不到问题——比如邮件没有parts结构、parts[0]不存在、body没有data字段等情况，都会直接跳过，无法排查原因。

3. 邮件结构处理不完善

   • 不是所有邮件都包含parts：部分纯文本邮件的内容直接存在于payload['body']['data']中，没有parts层级，代码强行取parts[0]会触发异常被跳过。
   • BeautifulSoup使用错误：soup.body()是调用方法，应该改为soup.body.get_text()或soup.get_text()来提取文本内容，否则会返回BeautifulSoup对象而非邮件正文。

4. 未指定邮件范围，可能遗漏非收件箱邮件
   默认的messages().list方法只会返回“收件箱”里的邮件，如果2FA邮件被自动归类到“促销”“更新”等标签文件夹，就会被漏掉。

修复建议 #

1. 用q参数精准过滤2FA邮件
   比如针对特定发件人或主题关键词查询：

   # 示例：搜索主题包含“验证码”且来自某平台的邮件
   result = service.users().messages().list(
       userId='me',
       q='subject:"验证码" from:noreply@example.com',
       maxResults=10  # 适当扩大范围
   ).execute()
   

2. 完善邮件结构解析逻辑
   处理有parts和无parts的两种情况：

   # 替换原有的parts解析部分
   if 'parts' in payload:
       parts = payload['parts'][0]
       data = parts['body']['data']
   else:
       data = payload['body']['data']
   data = data.replace("-","+").replace("_","/")
   decoded_data = base64.b64decode(data)
   soup = BeautifulSoup(decoded_data, "lxml")
   body = soup.get_text(strip=True)  # 提取纯文本正文
   

3. 优化异常处理，保留错误信息
   替换宽泛的except:为具体异常捕获，方便排查：

   try:
       # 原有逻辑
   except (KeyError, IndexError) as e:
       print(f"处理邮件 {msg['id']} 出错: {str(e)}")
   

4. 指定要查询的标签范围（可选）
   如果需要包含其他标签的邮件，添加labelIds参数：

   result = service.users().messages().list(
       userId='me',
       labelIds=['INBOX', 'CATEGORY_PROMOTIONS', 'CATEGORY_UPDATES'],
       q='subject:"验证码"'
   ).execute()
   

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