Minikube中容器出现CrashLoopBackOff状态故障排查求助

以下是针对你遇到的CrashLoopBackOff问题的排查建议，从镜像本身到Kubernetes配置逐一验证：

1. 先验证Docker镜像本地运行是否正常 #

Kubernetes里的容器问题很多根源在镜像本身，先跳过K8s直接在本地测试：

docker run -p 3000:3000 xxxtest/my-first-repo:yyy-frontend

观察容器是否能启动，有没有日志输出。如果本地启动就失败，直接排查镜像构建问题：

• 检查package.json里的dev脚本是否正确（比如Create React App是"start"，Vite是"vite"，不要写错）
• 手动在本地项目目录执行npm run dev，确认项目本身能正常启动

2. 检查React开发服务器的监听地址 #

大部分React脚手架的开发服务器默认只监听127.0.0.1，在容器环境中，这种配置可能导致进程异常退出或者Kubernetes无法探测到存活状态。修改Dockerfile，添加环境变量强制服务器监听所有网卡：

FROM node:18
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 3000
# 强制dev服务器监听0.0.0.0，允许容器外部访问
ENV HOST=0.0.0.0
CMD ["npm", "run", "dev"]

重新构建并推送镜像后，再部署到Minikube测试。

3. 查看容器退出的具体原因（无日志时的排查技巧） #

如果kubectl logs没有输出，可通过临时运行容器并手动执行命令来排查：

# 启动一个临时容器，用sleep保持运行
kubectl run temp-frontend --image=xxxtest/my-first-repo:yyy-frontend --command -- sleep 3600
# 进入容器
kubectl exec -it temp-frontend -- sh
# 在容器内手动执行启动命令，查看具体报错
npm run dev

这一步能直接看到启动失败的详细信息，比如依赖缺失、配置错误等。

4. 确认Minikube能正确拉取镜像 #

Minikube有独立的Docker环境，如果你是本地构建的镜像，需要把镜像加载到Minikube中，否则会拉取失败：

# 把本地镜像加载到Minikube节点
minikube image load xxxtest/my-first-repo:yyy-frontend

或者确保镜像已经推送到Docker Hub，且Minikube节点能访问到该镜像仓库。

5. 检查Pod的详细状态信息 #

执行kubectl describe pod <你的前端Pod名称>，除了BackOff警告，还要关注：

• Events栏是否有Failed to pull image或Error: ImagePullBackOff提示（镜像拉取失败）
• State栏的Exit Code，比如退出码为1通常是命令执行失败，退出码0是正常退出但K8s期望进程持续运行

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