Netlify部署含共享库的pnpm Monorepo应用失败排查与解决

1. 是否需要添加post-install脚本？ #

需要。Netlify默认只会执行根目录的pnpm install，不会自动构建共享库。你可以在根目录的package.json里添加postinstall脚本，让依赖安装完成后自动编译@monorepo/common-ui：

{
  "scripts": {
    "postinstall": "pnpm --filter @monorepo/common-ui build"
  }
}

这样Netlify每次部署时，都会先把共享库的产物和类型声明生成好，主应用构建时就能正常找到依赖。

2. 是否缺失配置？ #

大概率存在配置疏漏，重点检查这几个点：

• Netlify构建命令：不要直接执行主应用的build命令，得先构建共享库再处理主应用。在根目录package.json里定义组合脚本：

  {
    "scripts": {
      "build:netlify": "pnpm --filter @monorepo/common-ui build && pnpm --filter @monorepo/main-app build"
    }
  }
  

  然后去Netlify控制台把构建命令改为pnpm run build:netlify。
• pnpm workspace配置：确认根目录的pnpm-workspace.yaml正确包含两个包的路径：

  packages:
    - packages/common-ui
    - packages/main-app
  

• TypeScript路径映射：检查main-app的tsconfig.json，确保路径映射指向正确位置——开发时可以指向源码目录../common-ui/src，构建阶段如果依赖dist产物，就指向../common-ui/dist，同时要保证common-ui的build脚本会把.d.ts类型文件输出到dist目录。

3. 是否要将@monorepo/common-ui的dist目录提交至Git？ #

完全不建议。提交dist会增大仓库体积，而且每次修改共享库都要手动同步dist文件，容易出现版本不一致的问题。依赖构建阶段自动编译才是更规范、更省心的方案，也就是前面提到的postinstall脚本或组合构建命令的方式。

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