Teams对话窗口Bot报错“There was a problem reaching this app”无法消除

1. 优先清理Teams桌面端缓存 #

桌面端和Web端表现不一致90%以上都是本地缓存冲突导致，按以下步骤操作：

• 完全关闭Teams客户端（右键任务栏Teams图标选择「退出」，禁止仅关闭窗口）
• 打开Windows资源管理器，输入路径 %appdata%\Microsoft\Teams 回车
• 删除该目录下以下文件夹：Cache、Blob_storage、Databases、GPUCache、IndexedDB、Local Storage、tmp
• 重启Teams客户端重新测试即可

2. 校验机器人响应合规性 #

Teams桌面端对返回结果的校验远严格于Web端，重点检查两项：

• 所有响应Teams的HTTP请求必须返回 200 OK 或者 201 Created 状态码，哪怕业务逻辑执行完成，返回 204 No Content 也会被桌面端判定为请求失败触发错误提示
• 检查返回的自适应卡片JSON完全符合Teams规范，禁用自适应卡片1.6及以上版本的特性（Teams目前最高兼容1.5版本），使用官方校验工具排查卡片的必填字段缺失、语法错误问题

3. 核对Bot与Manifest配置 #

• 确认Azure Bot服务的Teams渠道已正常启用，消息端点为公网可访问地址，无防火墙、IP白名单拦截Teams官方的请求IP段
• 若使用ngrok等内网穿透工具调试，每次重启穿透工具后必须同步更新Azure Bot配置中的消息端点地址
• 把机器人服务、卡片资源用到的所有域名都添加到manifest.json的validDomains列表中，不要仅配置Tab相关域名

4. 临时清除错误占用窗口 #

调试阶段可临时移除错误提示条：

• 打开Teams设置-常规，开启「开发人员预览」模式，重启后右键错误条即可选择移除
• 也可直接清空当前和机器人的对话历史，即可清除常驻的错误提示

相关参考截图 #

内容的提问来源于stack exchange，提问作者Rich H.