AB
AiBoss
ニュース

Vercel Sandbox 创建完成后即返回可用沙箱

Vercel 更新 Sandbox 创建行为:Sandbox.create() 现在会等到快照恢复完成后才返回,首个命令或文件操作无需再等待;启动错误也会在创建阶段直接抛出。官方称该变更自动生效,无需升级 SDK 或修改配置。

核心事实

Vercel 在其更新日志中宣布,新建的 Vercel Sandbox 在创建完成时即可运行命令、读写文件。Sandbox.create() 现在只在快照恢复(snapshot restoration)完成后才 resolve,因此紧随其后的第一个命令或文件操作不再需要等待恢复过程。同时,启动阶段的错误会直接让 Sandbox.create() reject,而不是等到后续操作时才暴露。

官方给出的示例显示,创建后可以立即调用 sandbox.runCommand('node', ['--version']),无需额外等待。

背景与影响

此前快照恢复的耗时被计入首次操作,现在则计入创建阶段。Vercel 表示,创建耗时在 p50 上大约增加 50 毫秒,对于未缓存的快照,增幅可能更大;但「到首次操作完成」的总时间保持不变。也就是说,等待被前移,而不是被消除。

该变更自动生效,无需升级 SDK,也无需修改配置。对于依赖 Sandbox.create() 返回后立即执行操作的代码,行为语义更明确:返回即代表沙箱已就绪。

限制与来源

上述耗时数字来自 Vercel 官方更新日志,未提供更细分的基准测试条件,实际表现可能因快照是否缓存、运行环境等因素而异。具体 API 行为与最新说明请以 Vercel 官方文档中 Sandbox.create() 的当前内容为准。

来源:Vercel 更新日志《Vercel Sandbox creation now returns a ready sandbox》,作者 Tom Lienard,发布于 2026 年 10 月 8 日。