使用.NET SDK开发的Microsoft Teams Bot重新添加后无法交互

结合你用.NET SDK开发Teams机器人、更新后重新侧载出现的问题，我整理了几个针对性的排查方向，你可以一步步来：

• 检查manifest.json的关键配置

  • 先确认bots节点下的scopes数组，必须同时包含team和personal，这两个分别对应团队内@提及和一对一聊天场景，少了哪个就会导致对应功能失效
  • 核对botId是否和Azure Bot Framework注册里的机器人ID完全一致，更新过程中如果机器人ID变动（比如重新注册），manifest里的ID必须同步修改
  • 留意有没有误改isNotificationOnly这类字段，如果设为true，机器人只能发消息不能接收，自然无法响应你的输入

• 验证Azure Bot Framework的通道配置

  • 登录Azure Portal找到你的机器人资源，进入「Channels」标签页，确认Microsoft Teams通道是启用状态，没有被禁用或配置错误
  • 检查「Settings」里的「Messaging endpoint」是否正确，更新机器人后如果后端接口地址变了，这里必须同步更新，否则Teams无法把用户的消息转发给你的机器人
  • 如果机器人用到了身份验证，检查「OAuth Connection Settings」里的配置是否有效，比如客户端密钥有没有过期、权限范围有没有变动

• 排查机器人代码的更新影响

  • 如果你升级了.NET SDK版本，建议查看官方的版本变更日志，确认有没有破坏性改动（比如消息处理的接口、@提及解析的逻辑变化）
  • 开启机器人的日志功能，比如用Microsoft.Extensions.Logging记录请求和错误，看看当你尝试@提及或输入消息时，机器人有没有收到请求，有没有抛出异常
  • 检查代码里有没有新增的逻辑限制，比如不小心加了只允许特定团队ID的过滤，或者误删了处理@提及消息的代码段

• 清理客户端缓存并重新侧载

  • Teams客户端的缓存可能会残留旧配置，建议完全退出Teams（包括后台运行的进程），重新登录后再测试
  • 重新侧载时，删掉旧的机器人应用包，用更新后的manifest.json重新打包上传，不要直接覆盖旧应用
  • 换不同的Teams客户端（桌面端、网页端、移动端）测试，排除客户端本身的兼容性问题

• 检查团队权限设置

  • 确认添加机器人的账号拥有团队管理员权限，普通成员添加的机器人可能会受到功能限制
  • 进入团队的「设置」→「应用」，检查有没有禁止机器人的@提及或消息接收功能

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