在Jenkins流水线中运行Robot Framework测试时调用Microsoft Graph API获取邮件内容失败的问题排查

看起来你遇到了典型的「本地正常、Jenkins失败」自动化测试问题，这类情况大多和环境差异或自动化流程的鲁棒性有关。我帮你梳理几个核心排查方向和解决思路：

一、最根本的适配问题：授权码流不适合Jenkins自动化场景 #

你的测试采用的是授权码流（需要用户交互式登录），本地运行时你可以手动处理登录、权限同意等步骤，但Jenkins是完全无头的自动化环境，很容易因为额外验证步骤（比如设备检查、首次权限同意弹窗）卡住流程。

推荐解决方案：改用客户端凭据流 #

这是彻底解决问题的最优方案，客户端凭据流基于应用身份，无需用户交互，完美适配Jenkins这类自动化场景：

1. 在Azure AD应用注册中，添加应用权限（比如Mail.Read），并联系管理员完成权限授予；
2. 修改Flask应用的Token获取逻辑：

   # 替换原有的scope和Token获取代码
   scope = ['https://graph.microsoft.com/.default']  # 应用权限的固定scope格式
   
   # 直接通过客户端凭据获取Token，无需交互式登录
   token_result = client.acquire_token_for_client(scopes=scope)
   if 'access_token' in token_result:
       access_token = token_result['access_token']
   else:
       logging.error(f"Token获取失败：{token_result.get('error_description')}")
   

3. 调整Graph API调用路径：应用权限下无法使用/me/messages，需要指定目标用户邮箱，示例：

   api_url = ('https://graph.microsoft.com/v1.0/users/{目标邮箱}/messages?$search="USPTO: Your authentication code"&$top=3')
   

改造后整个流程无需浏览器登录，彻底规避Jenkins中的交互式登录卡点。

二、如果暂时不想修改授权方式，排查Jenkins环境差异问题 #

1. 浏览器环境配置差异 #

Jenkins的无头浏览器和本地配置存在明显区别：

• 固定窗口大小：Azure登录页面在小窗口下会改变布局，导致元素定位失效，在Robot脚本中添加：

  Set Window Size    1920    1080
  

• 添加必要的无头启动参数：容器化的Jenkins环境中，Chrome无头模式需要额外参数才能正常运行，修改浏览器启动关键字：

  Open Browser    ${FLASK_APP_URL}    Chrome    options=add_argument("--headless=new");add_argument("--no-sandbox");add_argument("--disable-dev-shm-usage")
  

2. 环境变量与网络可达性 #

• 环境变量缺失：本地通过.env加载Azure配置，但Jenkins需要手动注入环境变量。在Jenkins流水线配置中添加AZURE_CLIENT_ID、AZURE_CLIENT_SECRET、TENANT_ID，确保和本地配置一致；
• 网络访问问题：Flask应用默认绑定localhost:5000，如果Jenkins以容器运行，localhost指向容器内部，浏览器（容器内）无法访问宿主机的Flask服务。修改Flask启动代码，让服务监听所有网卡：

  if __name__ == '__main__':
      app.run(debug=True, port=5000, host='0.0.0.0')
  

  同时将redirect_uri修改为Jenkins节点可访问的地址。

3. 元素定位与等待逻辑优化 #

• 优化等待逻辑：点击${OUTLOOK_NO_BTN}后直接查找目标元素，可能页面还在加载/跳转中，建议先等待页面状态稳定：

  # 点击NO按钮后，先等待加载指示器消失
  Wait Until Page Does Not Contain Element    ${LOADING_SPINNER}    60s
  # 再等待目标元素出现
  Wait Until Page Contains Element    ${PAIR_CODE_TEXT_VAL}    60s
  

• 替换不可靠的定位器：你使用的XPath依赖固定行索引（//table[@bgcolor="#ffffff"]/tbody/tr[3]/td/b），如果Jenkins环境中页面结构变化（比如多了一行元素），定位器会失效。改用基于内容的定位：

  ${PAIR_CODE_TEXT_VAL}    xpath=//table[contains(@bgcolor, "#ffffff")]//b[contains(text(), "authentication code")]
  

4. 调试技巧：捕获Jenkins页面状态 #

在测试失败步骤前添加截图，直观查看Jenkins中的页面状态（比如是否弹出权限同意框、页面加载失败）：

Capture Page Screenshot    ${WORKSPACE}/pre-failure-screenshot.png

备注：内容来源于stack exchange，提问作者Gaurav Marothia