执行yarn install后Backstage启动失败，报Schema错误

问题根源 #

报错指向@backstage/config-loader无法处理@backstage/plugin-proxy-backend/config.d.ts中的Partial<{[key:string]:string;Authorization:string;authorization:string;'X-Api-Key':string;'x-api-key':string;}>类型定义，新项目也触发该问题，说明是依赖版本不匹配或近期包更新引入了不兼容的Schema写法。

可行解决方案 #

1. 锁定兼容依赖版本 #

• 删除项目根目录的node_modules和yarn.lock
• 在package.json中明确指定兼容版本（以下版本经测试可解决该问题）：

  {
    "dependencies": {
      "@backstage/plugin-proxy-backend": "0.2.35"
    },
    "devDependencies": {
      "@backstage/config-loader": "0.1.19"
    }
  }
  

• 执行yarn install后重新启动yarn dev

2. 临时修改Schema文件（应急用） #

找到node_modules/@backstage/plugin-proxy-backend/config.d.ts，将报错的Partial类型替换为可选字段的对象定义：

{
  [key: string]: string;
  Authorization?: string;
  authorization?: string;
  'X-Api-Key'?: string;
  'x-api-key'?: string;
}

保存后启动服务，注意：重新安装依赖后需重复此操作，仅作临时应急。

3. 统一同步Backstage包版本 #

执行yarn backstage-cli versions:bump将所有Backstage相关包升级到最新兼容版本，或降级到你之前能正常运行的版本，再重新安装依赖启动。

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