Next build无法解析monorepo别名，Next.js+Express项目构建求助

问题描述 #

用Express后端搭了个Next.js前端的monorepo项目，开发模式下跑起来完全没问题，但在前端包目录执行pnpm build时编译直接挂了，怀疑是monorepo的配置坑，卡了快一周了，求解决。

复现步骤 #

• 进入front包目录
• 执行pnpm install
• 执行pnpm build

排查方向与解决办法 #

1. 调整pnpm的依赖hoist配置 #

monorepo里Next.js生产构建经常会因为依赖解析不到位报错，在front/package.json里加个pnpm的hoist规则，确保核心依赖被正确提升：

{
  "pnpm": {
    "public-hoist-patterns": [
      "next",
      "react",
      "react-dom"
    ]
  }
}

2. 给Next.js配置本地包转译 #

如果项目里有workspace内的本地共享包（比如后端的工具代码），Next.js生产构建不会自动转译这些包，得在front/next.config.js里显式指定：

/** @type {import('next').NextConfig} */
const nextConfig = {
  transpilePackages: ['@your-workspace/shared'], // 换成你实际的本地包名
}

module.exports = nextConfig

3. 检查生产环境变量 #

开发模式的环境变量和生产构建的可能不通用，确认front/.env.production存在，并且所有必要的变量（比如API地址）都配置好了。

4. 清理缓存重来 #

pnpm的缓存有时候会搞事情，先清缓存再重新安装构建：

pnpm store prune
cd front
pnpm install --force
pnpm build

额外检查项 #

• 确认pnpm-workspace.yaml里正确包含了所有包目录：

packages:
  - 'front'
  - 'server'

• 检查front/package.json里的本地依赖是不是用workspace:*版本引用的

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