Teams Bot登录授权后提示‘无法连接应用’的502错误求助

问题现象 #

• 开发了一款基于Teams的Bot，用于通过用户认证从AD获取数据

• 点击交互式卡片中的登录按钮，弹出权限授权窗口，关闭该窗口后出现“无法连接应用”提示

• 浏览器端使用Teams时捕获到以下错误：

  502 Bad Gateway
  请求地址：https://apac.ng.msg.teams.microsoft.com/v1/agents/XXXXXXXXX/invoke

  错误详情：

  {
    "errorCode": 1008,
    "message": "<BotError>Error when processing invoke response: Unexpected character encountered while parsing value: <. Path '', line 0, position 0.",
    "standardizedError": {
      "errorCode": 1008,
      "errorSubCode": 1,
      "errorDescription": "<BotError>Error when processing invoke response: Unexpected character encountered while parsing value: <. Path '', line 0, position 0."
    }
  }
  

排查方向 #

• 错误提示里的Unexpected character encountered while parsing value: <是核心线索，说明Bot在处理登录回调时返回的不是合法JSON格式数据，而是HTML内容（比如服务器错误页面）。检查Bot的登录回调逻辑，确认是否抛出异常导致服务返回HTML错误页，而非符合要求的JSON响应。
• 查看Bot服务的运行日志，确认授权回调环节是否有报错，比如AD接口调用失败、数据库连接异常等情况。
• 验证Teams Bot的OAuth配置，确保回调URL正确无误，授权流程完成后能正确触发Bot的回调接口，且接口能正常处理请求并返回JSON格式的响应。
• 排查网络链路问题，502错误可能是Teams网关与Bot服务之间的通信异常，比如Bot服务响应超时、防火墙拦截请求等，可测试Bot服务的可达性，确认服务能正常接收并响应Teams的请求。

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