Teams Bot SSO报错：找不到名为botconnection的连接设置

问题背景 #

配置步骤 #

• 在开发者门户注册机器人，通过Teams Toolkit创建应用
• 为添加SSO功能，创建多租户Azure Bot并新建应用
• 在机器人配置的OAuth连接设置中，创建Azure AD v2.0类型服务提供商，命名为botConnection
• 使用Teams Toolkit创建的应用的客户端ID和密钥，令牌交换URL设为api://botid-clientidofapp，租户为common，范围设置为User.Read、openId、email
• 已在应用清单中配置包含应用客户端ID的webApplicationInfo

问题现象 #

调试机器人时，触发OAuth开始对话抛出错误：

Could not find Connection Setting with name botconnection

排查与解决方案 #

1. 检查连接名称的大小写一致性
   Azure Bot的OAuth连接名称是大小写敏感的，你配置的连接名称是botConnection（首字母大写），但错误提示中是botconnection（全小写）。确认代码中调用OAuth对话框时使用的连接名称是否和Azure中配置的botConnection完全一致，包括大小写。

2. 验证Azure Bot资源的配置同步情况

   • 登录Azure Portal，找到你的Azure Bot资源，进入“设置”->“OAuth连接设置”，确认botConnection连接确实存在，且配置参数（客户端ID、密钥、令牌交换URL等）无误
   • 如果是通过Teams Toolkit部署的，检查本地配置文件（如env/.env.local或appsettings.json）中是否正确配置了ConnectionName参数，值需与Azure中的连接名称完全匹配

3. 确认应用清单的webApplicationInfo配置正确性
   确保webApplicationInfo中的id是Teams Toolkit创建的应用的客户端ID，resource字段设置为api://botid-<你的机器人ID>（替换为实际的机器人ID，而非应用客户端ID），示例配置如下：

   "webApplicationInfo": {
     "id": "<应用客户端ID>",
     "resource": "api://botid-<机器人ID>"
   }
   

4. 检查本地调试环境的配置加载
   如果是本地调试，确认Teams Toolkit生成的环境变量中是否包含正确的连接名称配置，避免本地配置覆盖了Azure中的设置。可以查看调试时的控制台输出，确认应用加载的连接名称参数是否正确。

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