Backstage前端插件启动报错：不支持Partial类型配置Schema

执行yarn start启动Backstage前端插件时触发错误：

Error: Invalid configuration schema in ../../../../node_modules/@backstage/backend-common/config.d.ts, the following definitions are not supported: Partial<{[key:string]:unknown;password:string;}>

环境信息 #

• yarn: 3.2.3
• node: 18
• macOS Sonoma 14.3.1
• Python: 3.10.12
• Backstage: 1.16.0

已尝试删除node_modules并重新执行yarn install，问题未解决。

1. 统一Backstage核心包版本 #

Backstage对核心依赖的版本一致性要求严格，检查项目根目录package.json中所有@backstage/*开头的依赖，确保版本全部为1.16.0（与你的Backstage核心版本匹配）。修改后执行：

yarn install

2. 彻底清理依赖缓存 #

仅删除node_modules可能无法清除缓存的旧依赖，连带清理Yarn缓存和锁文件：

yarn cache clean
rm -rf node_modules
rm yarn.lock
yarn install

3. 调整TypeScript配置跳过库类型检查 #

在项目根目录的tsconfig.json中，将compilerOptions.skipLibCheck设为true，绕过第三方库的类型定义检查：

{
  "compilerOptions": {
    "skipLibCheck": true,
    // 保留其他原有配置...
  }
}

该设置可直接规避类型定义不兼容导致的schema解析错误。

4. 升级Yarn到稳定版本 #

Yarn 3.2.3可能存在兼容性bug，尝试升级到3.x分支的最新稳定版：

yarn set version stable
yarn install

内容的提问来源于stack exchange，提问作者Nitin Daphale