Next.js应用Docker容器化后/app目录为空问题排查求助

核心错误点 #

• Dockerfile工作目录配置错误：WORKDIR . 未指定到/app，导致后续操作默认在容器根目录执行，而非目标/app目录。
• 未复制项目文件到镜像：Dockerfile缺少COPY命令，本地的项目代码、start.sh脚本都未打包进镜像，容器启动后自然没有内容。
• 命名卷挂载覆盖容器目录：你配置的webapp-volume:/app会在容器启动时，用空的命名卷直接覆盖容器内的/app目录——哪怕镜像里有内容，也会被清空。

修正后的配置文件 #

1. Dockerfile（生产环境优化版） #

FROM node:14-alpine AS builder

# 设置正确的工作目录
WORKDIR /app

# 先复制package文件，利用镜像缓存优化构建速度
COPY package*.json ./
RUN npm ci --only=production

# 复制全部项目源码
COPY . .

# 构建Next.js生产产物
RUN npm run build

# 生产环境镜像（精简体积）
FROM node:14-alpine

WORKDIR /app

# 从builder阶段复制依赖和构建好的产物
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/.next ./.next
COPY --from=builder /app/package*.json ./
COPY --from=builder /app/public ./public

EXPOSE 3000

# 直接启动生产服务，无需额外脚本
CMD ["npm", "start"]

2. docker-compose.yml（移除不必要的卷挂载） #

version: '3.9'

services:
  app:
    container_name: webapp
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "3000:3000"
# 生产环境不需要挂载/app卷，避免覆盖镜像内的应用文件

3. 关于卷挂载的正确用法 #

如果是开发环境需要实时同步代码，可使用绑定挂载代替命名卷：

volumes:
  - ./:/app

但生产环境绝对不要挂载/app目录，若需要持久化用户上传文件这类静态资源，应单独挂载特定子目录：

volumes:
  - webapp-uploads:/app/public/uploads

同时在compose末尾声明该卷：

volumes:
  webapp-uploads:

额外注意事项 #

• 若一定要保留start.sh，需在Dockerfile中添加COPY start.sh ./，并通过RUN chmod +x start.sh赋予可执行权限；但生产环境直接在Dockerfile中执行命令更简洁可靠。
• 生产环境用npm ci代替npm install，能保证依赖版本与package-lock.json完全一致，且安装速度更快。

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