如何使用Docker容器化React Next.js项目 运行找不到.next构建产物错误如何解决

• 卷挂载覆盖构建产物：你在docker-compose.yml中配置了./:/var/app的宿主机目录挂载，容器启动时该挂载会直接覆盖镜像构建阶段生成的所有容器内/var/app路径下的文件。你在Dockerfile中执行的npm run build生成的.next构建产物仅存在于镜像内部的/var/app路径下，被本地目录覆盖后，若本地未提前执行构建命令，就会出现找不到生产构建产物的报错。
• 次要优化点（非直接报错原因）：Dockerfile的步骤顺序可以调整为优先复制package.json、package-lock.json安装依赖，再复制剩余项目代码，避免每次修改代码都重新执行依赖安装步骤，提升构建效率。

生产环境推荐方案 #

直接删除docker-compose.yml中的volumes配置段，生产环境无需挂载本地代码，直接使用镜像内部预构建的代码运行即可，修改后的services配置示例：

version: '3.3'
services:
   next-project:
     container_name: next-project
     build: ./
     working_dir: /var/app
     restart: 'unless-stopped'
     env_file:
      - .env
     ports:
      - "54000:3002"

开发环境需热更新的方案 #

保留挂载的同时，添加匿名卷排除容器内的构建产物和依赖目录，避免被本地覆盖，修改volumes配置为：

volumes:
  - ./:/var/app
  - /var/app/.next
  - /var/app/node_modules

该配置会保留容器内部生成的.next和node_modules文件夹，不会被本地目录的对应内容覆盖。

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