Actions on Google v1迁移至v2 alpha时遇‘Response has already been sent’错误

嘿，这个问题我熟得很！你猜的没错——大概率就是异步调用没把Promise返回给Intent/Action处理器导致的。

问题根源 #

Actions on Google v2版本的SDK对异步流程的处理比v1严格得多：如果你的Intent处理器里有异步操作（比如API请求、数据库查询），但没有把对应的Promise返回给SDK，系统会默认认为你已经处理完请求，直接发送空响应或者提前结束对话。等你的异步回调触发，再调用conv.close()或conv.add()这类修改响应的方法时，就会抛出"Response has already been sent"的错误——因为响应早就发出去了，没法再修改。

从你的错误堆栈看，调用链是DialogflowConversation.add() → DialogflowConversation.close()，完全符合这个场景：异步回调里的close操作晚于系统默认的响应发送时机。

修复方案 #

核心就是让包含异步操作的Intent处理器返回Promise，告诉SDK“等我异步操作完再发响应”。下面给你两种常见的写法：

1. 用Promise链返回

app.intent('你的意图名称', conv => {
  // 关键：返回整个Promise链
  return fetch('https://你的API地址')
    .then(response => response.json())
    .then(data => {
      conv.close(`处理完成：${data.result}`);
    })
    .catch(error => {
      conv.close(`出错了：${error.message}`);
    });
});

2. 用async/await（更易读）

如果你的Node.js环境支持ES7+，推荐用async/await写法，逻辑更清晰：

app.intent('你的意图名称', async conv => {
  try {
    const response = await fetch('https://你的API地址');
    const data = await response.json();
    conv.close(`处理完成：${data.result}`);
  } catch (error) {
    conv.close(`出错了：${error.message}`);
  }
});

额外检查点 #

除了没返回Promise，还要排查这两个可能的坑：

• 有没有在异步操作之前就调用了conv.close()或conv.add()？比如不小心在Promise外面提前发送了响应，后面异步回调又重复操作。
• 有没有多个异步操作同时触发，其中一个提前结束了对话？比如两个并行的Promise，其中一个先调用了close，另一个后续再调用就会报错。

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