Nuxt应用Docker容器启动后立即以退出码0退出问题排查

问题现象 #

构建Nuxt应用的Docker镜像后，容器启动后立即退出，返回退出码0，查看容器日志仅输出以下内容，无有效报错信息：

> frontend@1.0.0 start
> nuxt start

现有配置 #

Dockerfile #

# Builder image
FROM node:16-alpine as builder

# Set up the working directory
WORKDIR /app

# Copy all files (Nuxt app) into the container
COPY ../frontend .

# Install dependencies
RUN npm install

# Build the app
RUN npm run build

# Serving image
FROM node:16-alpine

# Set up the working directory
WORKDIR /app

# Copy the built app
COPY --from=builder /app ./

# Specify the host variable
ENV HOST 0.0.0.0

# Expose the Nuxt port
ENV NUXT_PORT=3000
EXPOSE 3000

CMD ["npm", "run", "start"]

docker-compose.yml服务配置 #

frontend:
    container_name: frontend
    build:
      context: .
      dockerfile: ./docker/nuxt/Dockerfile
    ports:
      - "3000:3000"
    networks:
      - app-network

故障原因 #

• 核心触发点：Nuxt2 启动进程默认依赖tty环境，当前compose配置未分配伪终端、未保持标准输入打开，Nuxt进程启动后直接正常退出，不会抛出任何错误日志。
• 配置错误1：Dockerfile内COPY路径解析逻辑和预期不符。Docker构建时所有文件路径都是相对于build context（也就是compose里配置的.，即docker-compose.yml所在目录）解析的，规则上不允许使用..跳出context目录，当前写的COPY ../frontend .无法正确拷贝Nuxt项目文件，构建时要么报错要么复用了旧的无效缓存层。
• 配置错误2：Nuxt2 默认读取PORT环境变量识别要监听的端口，配置的NUXT_PORT不会被Nuxt识别。

修复方案 #

• 修改docker-compose.yml的frontend服务配置，添加tty和标准输入配置：

frontend:
    container_name: frontend
    build:
      context: .
      dockerfile: ./docker/nuxt/Dockerfile
    ports:
      - "3000:3000"
    networks:
      - app-network
    tty: true # 分配伪终端
    stdin_open: true # 保持标准输入打开
    restart: unless-stopped # 可选，配置异常自动重启

• 修正Dockerfile配置：
  • 修正COPY路径，根据实际目录结构调整：如果Nuxt项目存放在项目根目录下的frontend文件夹，就把COPY ../frontend .改成COPY ./frontend/ .；如果Nuxt项目直接放在根目录，就改成COPY . .
  • 修正端口环境变量，把ENV NUXT_PORT=3000改成ENV PORT=3000
  • 优化多阶段构建逻辑，减小生产镜像体积，修正后的Dockerfile参考：

# Builder image
FROM node:16-alpine as builder

WORKDIR /app

# 先拷贝依赖文件，利用Docker缓存加速构建
COPY ./frontend/package*.json ./
RUN npm ci

# 拷贝项目文件执行构建
COPY ./frontend/ .
RUN npm run build

# Serving image
FROM node:16-alpine

WORKDIR /app

# 仅拷贝生产运行必需的文件
COPY --from=builder /app/package*.json ./
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/.nuxt ./.nuxt
COPY --from=builder /app/nuxt.config.js ./
COPY --from=builder /app/static ./static

ENV HOST 0.0.0.0
ENV PORT=3000
EXPOSE 3000

CMD ["npm", "run", "start"]

• 清除旧缓存重新构建启动：

docker compose down
docker compose build --no-cache frontend
docker compose up -d frontend

排查验证 #

如果修改后仍有问题，可以先把Dockerfile的CMD临时改成CMD ["sleep", "3600"]，启动容器后执行docker exec -it frontend sh进入容器内部，手动执行npm run start查看完整输出，定位具体问题。

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