AI SDK 迁移实战：TypeScript 通过后生产环境还会坏在哪里？

AI SDK 值得升级，但生产迁移绝不是执行 Codemod、修完类型错误就结束。

对于只做文本生成的页面升级可能看起来很简单：

-system: 'Use tools before answering.'+instructions: 'Use tools before answering.'

至于流式结果也从，

-for await {+for await { persistPart;}

生命周期回调建议改为：

-onFinish {+onEnd { saveRun;}

但这些只是语法层变化。

真正影响生产环境的是：

• 顶层 toolCalls 的聚合范围；怎么说呢，
• response.messages 的结构；其实，
• Tool Call 与 Tool Attempt 的区分；
• Abort 后部分状态如何保存；
• Timeout 是否真的停止底层工作；按理说，
• Retry 是否会重复执行带副作用的 Tool。

测试环境建立与验证策略

为了把这些问题分开验证。我没有直接升级主项目，而是建立了两个隔离 Fixture。

xbstack-ai-sdk--migration-demo
├── v6
├── v7
├── migration-diff
├── benchmarks
├── docs
└── scripts

测试版本配置这方面，

Node.js:
AI SDK : ai@...
TypeScript: strictProvider: ai/test deterministic mock

两个版本执行相同的：

• PROMPT;
• Mock Model;
• L1 Tool;
• L1 Tool Result;
• PROMPT fail paths;
• User abort场景;说起来，
• User retry场景;怎么说呢，
• User timeout场景。

⚠️ 使用者痛点：在真实环境中网络波动、API Key缺失、旧 Node 版本都会导致未预期报错。确保测试覆盖这些边界非常关键。

AWS Node.js + ESM 要求确认

AWS Lambda / Cloudflare Workers 等 Serverless Runtime 必须支持 ESM，否则 API 调用都会失败。

json { "type"这方面，"module","engines": { 从"node"来看。">=" }

⚠️ 如果本地或 CI 环境仍停留在旧版 Node，后续的 API 修改没有意义。先行升级 Node 再迁移 SDK！老实说，

同一个 Tool Calling 任务。v6 和 v7 的结果差异

PROMPT: What is status of order A-?

• 第一步先调用: lookupOrder

 


{
"orderId": "A-","status": "ready_for_pickup"}

  ，  ，  ，  ，
result.toolCalls.arguments.orderId = 'A-'
result.toolCalls.arguments.status = 'ready_for_pickup'
  ，  ，老实说，

result.finalStep.toolCalls.arguments.orderId = 'A-'
result.finalStep.toolCalls.arguments.status = 'ready_for_pickup'