本地调试TeamsFx-Samples/share-now遇ProvisionError：无法配置机器人注册

问题背景 #

按照TeamsFx-Samples/share-now v1.1.0版本的指南在VS Code中调试项目，部署到Azure的流程正常，机器人已成功部署，但本地调试时“set-up-bot”任务失败，错误日志如下：

[2022-12-11T02:55:29.879Z] [Info] - Finished 'Set up tab' Visual Studio Code task in 0.12 seconds.
[2022-12-11T02:55:29.917Z] [Info] - Running 'Set up bot' Visual Studio Code task.

(Totally 5 steps) Teams Toolkit is setting up bot for debugging.

(1/5) Registering the AAD app which is required to create the bot ...
(2/5) Registering the bot in Bot Framework Portal ...

Summary:

√ Skip registering AAD app but use the existing AAD app from args: c87d9e6d-5f17-4c76-abe3-5a1c1643e937

× ProvisionError: Failed to provision Developer Portal bot registration.

问题解答 #

1. “在Bot Framework Portal中注册机器人”的作用是什么？ #

Bot Framework Portal里的机器人注册是机器人能在Teams中运行的必要环节，核心作用包括：

• 为机器人分配唯一的身份标识（App ID和密码），用于和Bot Framework服务、Teams平台做身份验证，确保通信安全
• 配置机器人的消息接收端点，让Teams平台知道把用户发送的消息转发到哪个地址
• 关联对应的AAD应用，实现机器人在Teams生态中的权限管控，比如访问用户信息、调用Graph API等
• 启用机器人的基础能力，比如消息收发、卡片交互、团队频道集成等，是机器人接入Teams的基础入口

2. 如何解决该错误？ #

针对ProvisionError: Failed to provision Developer Portal bot registration错误，可尝试以下解决方案：

• 检查账号权限：确认用于调试的微软账号拥有创建Bot注册的权限，需是Azure AD全局管理员、应用程序管理员，至少具备创建应用注册的权限
• 清理残留注册：前往Azure AD应用注册页面，找到日志中对应的AAD应用（ID：c87d9e6d-5f17-4c76-abe3-5a1c1643e937），检查是否已关联异常的Bot注册，若有则删除该Bot注册后重新运行调试任务
• 重置本地配置：在VS Code的Teams Toolkit面板中切换到本地调试环境，删除本地的.env.local配置文件，重新初始化本地调试环境
• 排查网络问题：确保本地网络可正常访问Bot Framework Portal和Azure服务，关闭可能拦截请求的代理或防火墙
• 手动注册Bot：若自动注册持续失败，可手动前往Bot Framework Portal创建Bot注册，关联现有AAD应用（即日志中的ID），然后将Bot的App ID和密码手动填入本地.env.local文件的BOT_ID、BOT_PASSWORD变量中

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