React应用Docker ENTRYPOINT在Kubernetes Deployment中未执行的问题排查

核心问题梳理 #

• Deployment配置过度覆盖容器启动命令：K8s 中Pod的command、args字段会完全覆盖Docker镜像构建时定义的ENTRYPOINT和CMD逻辑，原配置中手动指定的/bin/bash + 自定义args，已经完全替换了镜像原本的启动入口，和直接执行docker run 镜像名的原生行为完全不一致。
• entrypoint.sh的后台进程逻辑导致容器主进程提前退出：脚本中( export REACT_APP_ENV_VAR=env_var_value;npm run start )用括号开启了独立子shell执行启动命令，父shell不会等待子进程运行结束，会直接继续执行到末尾的exec "$@"；当没有传入额外启动参数时，父shell会正常退出，容器主进程消失，触发K8s自动重启。这也是kubectl describe输出中显示容器“启动2秒后以Exit Code 0退出、重启次数累加”、移除command/args后日志卡在Starting the development server...无后续内容的根本原因。
• 容器端口元信息缺失：Pod的容器配置中没有声明containerPort: 3000，虽然不会直接导致启动失败，但会导致Service流量转发时无法匹配正确的后端端口，后续就算应用正常运行也会出现访问不通的问题。
• 手动指定启动命令的常见误区：如果直接在command里写npm run start，但没有处理好进程的前台绑定、环境变量注入逻辑，同样会因为主进程运行逻辑不对，出现应用没有正常启动的问题。

修复方案 #

1. 修正entrypoint.sh逻辑 #

移除不必要的子shell包裹逻辑，用exec将Node.js启动进程直接替换为容器主进程，保证应用在前台运行、能正确接收容器停止信号，修正后的脚本示例：

#!/bin/bash
set -e
# 直接导出环境变量
export REACT_APP_ENV_VAR=env_var_value
# 用exec把当前shell替换为npm启动进程，成为容器的PID 1
exec npm run start

2. 调整Deployment配置 #

• 删掉手动添加的command和args字段，直接沿用镜像自带的启动逻辑，和本地docker run的行为保持一致
• 补全容器端口声明，匹配Service的转发规则
• 如需注入环境变量，直接通过env字段配置，不要硬编码在启动命令中
  修正后的容器配置示例：

containers:
- name: my-app
  image: my-docker-image
  imagePullPolicy: Always
  ports:
  - containerPort: 3000
    protocol: TCP
  env:
  - name: REACT_APP_ENV_VAR
    value: "env_var_value"
  # 可选：添加就绪探针，等应用完全启动后再接入流量
  readinessProbe:
    httpGet:
      path: /
      port: 3000
    initialDelaySeconds: 10
    periodSeconds: 5

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