yarn安装Keystone后postinstall报Couldn't find a Program如何解决

执行yarn依赖安装完成后，Keystone.js 自动触发 postinstall 流程时抛出编译异常，初步定位为Babel编译故障，初始报错提示为 keystone.ts: Couldn't find a Program，对应错误码为 BABEL_TRANSFORM_ERROR，完整报错栈如下：

at Scope.getProgramParent (/user-service/node_modules/next/dist/compiled/babel/bundle.js:1910:391266)
at Scope.crawl (/user-service/node_modules/next/dist/compiled/babel/bundle.js:1910:389859)
at Scope.init (/user-service/node_modules/next/dist/compiled/babel/bundle.js:1910:389648)
at NodePath.setScope (/user-service/node_modules/next/dist/compiled/babel/bundle.js:1910:318551)
at NodePath.setContext (/user-service/node_modules/next/dist/compiled/babel/bundle.js:1910:318706)
at NodePath.popContext (/user-service/node_modules/next/dist/compiled/babel/bundle.js:1910:319657)
at TraversalContext.visitQueue (/user-service/node_modules/next/dist/compiled/babel/bundle.js:1910:311327)
at TraversalContext.visitMultiple (/user-service/node_modules/next/dist/compiled/babel/bundle.js:1910:310771)
at TraversalContext.visit (/user-service/node_modules/next/dist/compiled/babel/bundle.js:1910:311441)
at traverseNode (/user-service/node_modules/next/dist/compiled/babel/bundle.js:1910:396041)

• 优先检查keystone.ts配置文件本身的语法合法性：该报错本质是Babel遍历代码AST结构时，找不到根级Program节点，绝大多数场景是配置文件存在语法截断、未闭合的括号/装饰器、错误的TS语法、导入路径错误导致文件解析为空。
• 核对依赖版本匹配关系：报错栈指向Next.js内置打包的Babel运行包，需确认当前项目安装的Keystone.js版本与Next.js版本是否在官方兼容区间内，是否存在手动升级单个依赖导致跨大版本不兼容、锁文件损坏引发多版本Babel共存的问题。
• 排查Babel配置冲突：检查项目根目录及上层目录（monorepo场景）是否存在自定义的.babelrc、babel.config.js配置，自定义Babel插件如果和Keystone、Next.js内置的编译规则冲突，会直接打断AST解析流程触发该错误。
• 检查编译缓存是否损坏：postinstall流程会优先读取本地Babel缓存，若缓存文件写入异常损坏，会直接导致编译流程异常。
• monorepo场景额外检查依赖提升规则：确认Keystone、Next.js相关依赖是否被错误提升到仓库根目录，导致运行时引用了不一致的Babel实例。

• 校验配置文件语法：先使用最简Keystone配置替换现有keystone.ts内容，验证postinstall是否能正常运行，再逐步还原原有配置定位具体语法错误点。最简配置参考：

import { config } from '@keystone-6/core';
export default config({
  db: { provider: 'sqlite', url: 'file:./dev.db' },
  lists: {},
});

• 重装依赖对齐版本：删除node_modules目录、yarn.lock锁文件，重新执行yarn install安装依赖；若仍报错，对照Keystone官方版本兼容说明，将Next.js版本调整到对应支持的区间内，避免跨版本不兼容。
• 移除冲突配置：临时移走项目内所有自定义Babel配置文件、卸载自行安装的Babel相关插件依赖，重新运行postinstall验证是否恢复，后续再按需逐步加回配置定位具体冲突项。
• 清理缓存重试：执行以下命令清除损坏的编译缓存后重新触发流程：

rm -rf node_modules/.cache
yarn postinstall

• monorepo场景需在对应包的.npmrc或 workspace 配置中，将Keystone、Next.js相关依赖标记为不提升，保证包内引用的Babel实例一致。

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