Microsoft Teams Bot部署新版本至Azure后无通知发送问题求助

可能原因 #

• Teams客户端缓存未刷新，仍沿用旧版应用配置
• Bot注册端点与最新部署的函数URL未同步
• manifest版本号格式不规范，未被识别为有效更新
• 触发器路由或Bot签名验证配置不一致

解决步骤 #

1. 清理Teams客户端缓存并重装 #

• 卸载应用后，按对应平台清理缓存：
  • Windows：运行命令 %appdata%\Microsoft\Teams\Update.exe --processStart "Teams.exe" 重启Teams
  • Mac：退出Teams，删除 ~/Library/Application Support/Microsoft/Teams 文件夹后重启
• 从Teams应用目录或Developer Portal重新安装应用

2. 验证Bot配置同步 #

• 登录Azure Portal，检查Bot资源的配置页，确认消息端点与最新部署的Azure函数URL完全一致
• 在Teams Developer Portal的应用Bot配置页，确认关联的Bot注册资源正确，端点URL无错误
• 部署后先在Azure函数的触发器页测试HTTP请求，确认代码逻辑正常响应

3. 规范manifest版本号 #

• 确保manifest.json中的version字段为x.y.z三段式格式（如1.0.0→1.0.1），且版本号严格递增
• 发布前用Teams Toolkit的Validate Manifest工具检查版本号合规性

4. 排查触发器验证逻辑 #

• 确认代码中使用的Microsoft App ID和Microsoft App Password与Azure Bot Service配置完全一致
• 在HTTP触发器代码中添加日志，记录请求头、参数及错误信息，排查是否存在请求拦截情况

5. 优化发布流程 #

• 使用Teams Toolkit的Publish to Teams功能完成发布，替代手动在Developer Portal操作，确保manifest与Bot配置自动同步
• 每次更新先在本地或Azure测试触发器可用性，再发布到Teams

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