Next.js 13项目Docker-Compose部署报错：缺失BUILD_ID文件

问题原因 #

你的核心问题在于docker-compose.yml中的volumes挂载配置。Dockerfile构建阶段已经在容器内执行npm run build生成了.next目录，但你通过volumes将本地开发目录挂载到容器的/app路径，这会直接覆盖容器内原本构建好的文件——本地目录中没有构建后的.next文件夹，导致启动next start时找不到BUILD_ID文件。

最简解决方案（生产环境） #

移除docker-compose配置中的volumes项即可。生产部署场景下，容器本身已经包含完整的构建产物，不需要挂载本地目录。

修改后的docker-compose.yml：

version: '3.8'

services:
  next-app:
    build:
      context: .
      dockerfile: C:\Users\user\WorkSpace\Test\Docker\app\my-app\Dockerfile
    ports:
      - '3000:3000'
    environment:
      - NODE_ENV=production

可选：开发环境热重载配置（如果需要本地代码实时同步） #

若要在开发环境使用挂载实现热重载，需避免本地目录覆盖容器内的依赖和构建产物：

1. 在项目根目录创建.dockerignore文件，添加以下内容：

node_modules
.next

2. 修改Dockerfile为开发模式（仅用于开发）：

FROM node:18
WORKDIR /app

COPY ./app/my-app/package.json ./
RUN npm install

COPY . .

EXPOSE 3000

CMD ["npm", "run", "dev"]

3. 保留volumes的docker-compose.yml：

version: '3.8'

services:
  next-app:
    build:
      context: .
      dockerfile: C:\Users\user\WorkSpace\Test\Docker\app\my-app\Dockerfile
    ports:
      - '3000:3000'
    volumes:
      - C:\Users\user\WorkSpace\Test\Docker\app\my-app:/app
    environment:
      - NODE_ENV=development

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