解决Vercel AI SDK中streamText返回"An error occurred"错误的方法

在使用Vercel AI SDK开发聊天应用时，开发者可能会遇到一个常见问题：当调用streamText函数时，系统返回一个非描述性的"An error occurred"错误信息。这个问题通常发生在连续5-10次消息交互后，特别是在使用工具调用(tool calls)功能时。

问题现象

开发者观察到以下典型现象：

1. 聊天功能初始阶段工作正常
2. 经过5-10次消息交互后开始出现错误
3. 错误发生时，客户端仅收到"An error occurred"的通用提示
4. 工具调用功能可能无法正常执行
5. 错误发生后，聊天功能通常无法自动恢复

错误原因分析

经过深入分析，这个问题主要源于以下几个方面：

1. 错误处理机制：Vercel AI SDK默认不向客户端暴露完整的错误信息，这是出于安全考虑，防止敏感信息泄露。

2. 工具调用流程：当工具调用过程中出现问题时，错误可能被捕获但未正确传递。

3. 状态管理：长时间运行的聊天会话可能积累状态问题，导致后续操作失败。

解决方案

方法一：增强错误日志记录

在API路由中，使用try-catch块包裹所有函数调用和onFinish回调，手动打印错误信息：

try {
  const result = streamText({
    // 配置参数
    async onFinish({ response }) {
      try {
        // 处理逻辑
      } catch (error) {
        console.error('onFinish error:', error);
        throw error;
      }
    },
  });
  return result.toDataStreamResponse();
} catch (error) {
  console.error('StreamText error:', error);
  throw error;
}

方法二：自定义错误信息转发

Vercel AI SDK提供了自定义错误信息转发的功能，可以在保持安全性的同时提供更多调试信息：

return result.toDataStreamResponse({
  getErrorMessage: error => {
    if (error instanceof Error) {
      // 记录完整错误到服务端日志
      console.error('StreamText processing error:', error); 
      // 仅转发安全的信息到客户端
      return error.message; 
    }
    console.error('Unknown error:', error);
    return '处理请求时发生未知错误';
  },
});

最佳实践建议

1. 工具调用验证：确保所有工具函数都有完善的错误处理和日志记录。

2. 会话状态管理：定期清理或重置长时间运行的聊天会话状态。

3. 错误边界处理：在客户端实现错误边界组件，优雅地处理错误情况。

4. 监控与警报：设置服务端错误监控，及时发现和解决问题。

5. 版本兼容性检查：确保使用的SDK版本与文档示例保持一致。

总结

处理Vercel AI SDK中的"An error occurred"错误需要理解其背后的安全设计和错误处理机制。通过增强错误日志记录和合理配置错误信息转发，开发者可以在保持系统安全性的同时获得足够的调试信息。实施上述解决方案后，开发者将能够更有效地诊断和解决聊天应用中出现的各种问题，提升用户体验和系统稳定性。