使用dispatch CLI结合LUIS与QnA开发Bot时端点报401且模拟器报错

401未授权错误常见触发原因 #

• 配置参数错配：
  • applicationId字段没有填写Dispatch CLI生成的专属调度模型ID，错填为原始子LUIS应用、QnA Maker应用的ID
  • endpointKey错用LUIS创作密钥替代预测端点密钥，两类密钥权限完全隔离，创作密钥无法调用预测接口，必然返回401
  • 主机名拼接错误：代码逻辑会自动给主机名拼接.api.cognitive.microsoft.com后缀，若LuisAPIHostName环境变量提前携带了完整域名，会导致请求端点偏移，无法通过鉴权
• 模型发布流程缺失：Dispatch生成的调度模型、关联的LUIS/QnA子服务完成训练后，必须手动发布到LUIS门户的对应预测槽位，仅训练不发布的模型无法被预测端点访问，会返回鉴权类错误。

Bot Emulator崩溃报错的排查点 #

• 当前代码配置存在两个直接导致无提示崩溃的问题：
  • LuisRecognizer构造函数传入的第三个true参数会静默吞掉接口抛出的异常，401类鉴权错误不会被打印到控制台，最终因未捕获的Promise rejection触发整个消息处理管道中断，弹出模拟器的“机器人遇到错误”提示
  • 识别调用逻辑没有加异常捕获，单个认知服务接口请求失败就会直接打断机器人的正常响应流程
• 修正后可运行的代码参考：

  // 初始化Dispatch识别器，端点直接使用LUIS门户提供的完整预测地址
  const dispatchRecognizer = new LuisRecognizer({
    applicationId: process.env.LuisAppId,
    endpointKey: process.env.LuisAPIKey,
    endpoint: process.env.LuisEndpoint
  }, {
    includeAllIntents: false,
    includeInstanceData: false,
    logOriginalMessage: true
  });
  
  this.onMessage(async (context, next) => {
    console.log('Processing Message Activity.');
    let recognizerResult;
    try {
      recognizerResult = await dispatchRecognizer.recognize(context);
      const intent = LuisRecognizer.topIntent(recognizerResult);
      console.log('识别到的顶层意图：', intent);
      await this.dispatchToTopIntentAsync(context, intent, recognizerResult);
    } catch (error) {
      // 打印具体报错，快速定位配置问题
      console.error('Dispatch模型识别失败：', error);
      await context.sendActivity('当前服务暂时异常，请检查配置后重试');
    }
    await next();
  });
  

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