MS Teams中Bot无响应问题排查求助

既然Azure的「Test in web chat」能正常收到响应，说明你的Bot核心逻辑和基础身份验证是没问题的，问题基本集中在Teams侧的配置或连接环节，我给你梳理几个关键排查点：

• 核对Manifest文件的Bot配置

  • 确认manifest里的bots数组中，botId完全匹配Azure Bot注册页面的Microsoft App ID（是GUID格式的那个ID，不是显示名称）
  • 检查scopes字段是否包含你测试场景的范围：比如你在私聊测试，就得有personal；在团队里测试，就得有team，范围不匹配会导致Bot收不到消息
  • 不需要的功能字段（比如supportsCalling）建议设为false，避免冗余配置干扰

• 确认Teams应用的安装状态

  • 先确认上传到Teams的是最新修改后的manifest压缩包，别不小心传了旧版本
  • 尝试卸载Teams里的应用，清理客户端缓存后重新安装——Teams经常会缓存旧配置，导致新设置不生效
  • 检查安装范围：如果是上传到特定团队，就只能在该团队聊天里测试；个人应用要在个人聊天窗口测试

• 检查Azure Bot的Teams通道配置

  • 登录Azure Bot Service，进入「Channels」页面，确保Microsoft Teams通道是启用状态（显示「已配置」）
  • 进入Teams通道的配置页，确认「Messaging endpoint」和你Bot代码里的端点完全一致，别忘了带/api/messages后缀（比如https://your-bot-domain.azurewebsites.net/api/messages）
  • 点击配置页的「验证连接」，看看是否能成功建立连接，这能快速排查端点可达性问题

• 排查签名验证与身份配置

  • 虽然Web Chat正常，但Teams的请求签名验证逻辑有差异，如果你用Bot Framework SDK，确认代码里正确处理了Teams的签名
  • 再次核对MicrosoftAppId和MicrosoftAppPassword：这两个值要和Azure Bot注册、manifest里的完全一致，不能有空格或拼写错误
  • 查看Bot的运行日志（比如Azure App Service的日志或本地调试日志），看看是否收到Teams的请求，有没有401未授权这类报错——这类错误通常是签名验证失败导致的

• 测试不同交互场景

  • 先别着急测试命令，发送一条普通消息（比如「hello」）看看Bot有没有响应，排除命令触发关键词配置的问题
  • 在Teams桌面端、移动端、网页端分别测试，排除客户端缓存或兼容性问题

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