NextJS 15.0.2升级后触发TypeError: maybeGlobalAsyncLocalStorage.snapshot is not a function

错误详情 #

升级至Next.js 15.0.2后触发以下错误：

TypeError: maybeGlobalAsyncLocalStorage.snapshot is not a function

对应出错代码片段：

58 | ) => R {
  59 |   if (maybeGlobalAsyncLocalStorage) {
> 60 |     return maybeGlobalAsyncLocalStorage.snapshot()
     |                                         ^
  61 |   }
  62 |   return function (fn: any, ...args: any[]) {
  63 |     return fn(...args)

解决方案 #

根据社区讨论总结的有效处理方式：

• 排查依赖冲突：该错误多由async_hooks相关依赖或第三方库（如状态管理、请求类库）与Next.js 15内部实现不兼容导致。执行npm list async_hooks或yarn list async_hooks查看依赖树，移除重复或版本不匹配的依赖包。
• 重置依赖缓存：删除node_modules、package-lock.json（或yarn.lock）文件，重新执行npm install/yarn install，确保依赖完全适配Next.js 15.0.2。
• 更新第三方库：若使用了react-query、sentry等涉及异步上下文的库，升级至支持Next.js 15的最新版本——旧版本可能依赖了Next.js 15已弃用的asyncLocalStorage API。
• 临时降级Next.js：如果上述方案均无效，可暂时降级到Next.js 14.x稳定版，待相关依赖完成适配后再升级。

内容的提问来源于stack exchange，提问作者Code on the Rocks