NodeJS QnA模板机器人无法使用，Web Chat测试显示等待就绪求助

我来帮你排查这个QnA机器人卡在「Waiting for bot to be ready」的问题——既然基础模板能正常运行，那问题大概率出在QnA相关的配置、服务连通性或者代码细节上，试试下面这些分步排查方案：

别小看这一步，很多时候都是参数复制错了导致的：

• 确认QnAKnowledgebaseId：去QnA Maker门户打开你的知识库，在「Settings」标签页里复制Knowledge base ID，别把资源ID或者其他混淆的ID抄进去；
• 确认QnASubscriptionKey：去Azure门户找到你的QnA Maker资源，进入「Keys and Endpoint」页面，复制其中一个密钥（两个都可用），注意这不是机器人本身的密钥，别搞混了；
• 检查Azure应用设置的有效性：在机器人资源的「Configuration」页面，确认这两个参数没有多余空格、大小写错误，并且确实已经保存生效。

先排除QnA服务端的问题：

• 登录QnA Maker门户，在你的知识库的「Test」面板里直接提问，看能不能正常返回答案。如果这里都出问题，那机器人肯定连不上；
• 去Azure门户查看QnA Maker资源的「Overview」页面，确认服务状态正常，没有欠费、停用或者配额耗尽的情况。

NodeJS模板的QnA逻辑可能有细节配置错误：

• 找到代码中QnA相关的配置文件（比如config.js或者对话逻辑文件），确认QnA服务的端点是否和你的资源区域匹配，格式应该是https://<你的QnA资源名>.cognitiveservices.azure.com/qnamaker/v4.0；
• 检查API版本是否正确，旧版本的API可能已经被废弃，导致调用失败。

日志是定位问题的关键：

• 在Azure机器人资源的「Monitoring」→「Logs」里，搜索QnA相关的错误信息，比如401（密钥无效）、404（知识库ID不存在）这类HTTP状态码，能直接指明问题；
• 本地运行代码调试：把本地配置文件的参数填对，启动机器人后测试本地Web Chat，同时看控制台输出的报错信息，这种方式更容易快速定位代码或配置问题。

虽然基础模板能运行，但还是要做个快速检查：

• 确认机器人的「Messaging endpoint」是可访问的：用浏览器访问这个端点，正常情况下会返回「Bad Request」（因为需要特定格式的请求），如果返回404或500，说明部署有问题；
• 检查Web Chat通道：在「Channels」页面确认Web Chat的配置正常，密钥没有过期。

有时候Azure的缓存会导致配置未生效：

• 重启机器人的App Service：在机器人资源的「Overview」页面点击「Restart」；
• 重新推送一次代码部署，确保最新的配置被完全应用。

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