Docker+Kubernetes环境下React微服务构建失败Pod未运行求助

问题现象 #

开发基于Docker和Kubernetes的微服务项目，包含React前端客户端及多个后端服务。查看客户端日志时出现如下报错：

构建失败，因为进程过早退出。这可能意味着系统内存不足，或者有人对进程执行了kill -9命令。

执行kubectl get pods可见客户端Pod未处于运行状态。

相关配置文件 #

客户端Dockerfile #

FROM node:alpine

WORKDIR /app
COPY package.json ./
RUN npm install
COPY ./ ./

CMD ["npm", "start"]

Kubernetes客户端部署文件（/infra/k8s/client-depl.yaml） #

apiVersion: apps/v1
kind: Deployment
metadata:
  name: client-depl
spec:
  replicas: 1
  selector:
    matchLabels:
      app: client
  template:
    metadata:
      labels:
        app: client
    spec:
      containers:
      - name: client
        image: shanbiswas/client:latest
        # resources:
        #   limits:
        #     memory: "256Mi"
        #     cpu: "500m"
---
apiVersion: v1
kind: Service
metadata:
  name: client-srv
spec:
  selector:
    app: client
  type: ClusterIP
  ports:
  - name: client
    protocol: TCP
    port: 3000
    targetPort: 3000

排查方向与解决方案 #

1. 解决内存资源不足问题 #

报错核心指向内存不足，当前部署文件注释了资源限制，Kubernetes默认分配的资源可能无法支撑React开发服务器启动：

• 取消resources配置的注释，调整内存限制至合理值（建议提升到512Mi），同时添加资源请求配置：

  resources:
    limits:
      memory: "512Mi"
      cpu: "500m"
    requests:
      memory: "256Mi"
      cpu: "250m"
  

• 应用配置更新：执行kubectl apply -f infra/k8s/client-depl.yaml

2. 优化Docker镜像构建方式 #

当前Dockerfile直接启动React开发服务器，容器环境中易因资源占用过高或依赖问题启动失败。推荐使用多阶段构建生成生产环境静态文件，用Nginx托管：

• 修改Dockerfile为：

  # 构建阶段
  FROM node:alpine AS builder
  WORKDIR /app
  COPY package.json package-lock.json ./
  RUN npm ci
  COPY ./ ./
  RUN npm run build
  
  # 运行阶段
  FROM nginx:alpine
  COPY --from=builder /app/build /usr/share/nginx/html
  EXPOSE 80
  CMD ["nginx", "-g", "daemon off;"]
  

• 重新构建并推送镜像：docker build -t shanbiswas/client:latest . && docker push shanbiswas/client:latest
• 更新Kubernetes部署文件：将容器targetPort改为80，服务端口也可对应调整为80

3. 深入排查容器启动细节 #

若调整后仍失败，通过以下命令获取更多信息：

• 查看Pod完整日志：kubectl logs <pod-name>
• 查看Pod事件详情：kubectl describe pod <pod-name>
  这些信息能帮助定位是否存在依赖缺失、权限问题等隐藏故障。

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