移除NextJS项目pnpm-lock.yaml后独立构建输出结构异常求助

问题场景 #

项目为Yarn工作区结构：

workspaceRoot
  apps
    common
    web-common
    server-common
    chat

其中chat是Next.js 14.3应用，存在两种构建输出差异：

• 项目根目录有pnpm-lock.yaml（即使为空）时，独立构建输出结构：

  .next
    standalone
      server.js
  

• 移除pnpm-lock.yaml后，输出结构变为嵌套形式：

  .next
    standalone
      common
      web-common
      server-common
      chat
        server.js
  

解决方案 #

问题根源是Next.js在Yarn工作区环境下，未检测到pnpm锁文件时，会默认将整个工作区范围纳入构建跟踪，导致输出目录包含所有工作包子项目。通过以下配置调整即可修复：

1. 修改Next.js配置文件 #

在chat应用目录的next.config.js中添加experimental.outputFileTracingRoot配置，将构建跟踪根目录限定为当前应用目录：

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: 'standalone',
  experimental: {
    // 指定当前应用目录为构建跟踪根，避免打包整个工作区
    outputFileTracingRoot: __dirname,
  },
}

module.exports = nextConfig

2. 确保子项目标记为私有（可选） #

如果chat应用的package.json尚未设置，添加"private": true字段，明确告知Next.js这是工作区中的私有子项目：

{
  "name": "chat",
  "private": true,
  // 其他配置...
}

3. 重新构建 #

执行构建命令：

yarn build

此时standalone目录下会直接生成server.js，且仅包含chat应用所需的依赖，不会再出现工作区其他子项目目录。

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