GKE部署Nginx静态文件服务遇exec格式错误求助

在Google Kubernetes Engine（GKE）上部署React前端服务，采用Nginx作为静态文件服务器，部署时持续触发错误：exec /docker-entrypoint.sh: exec format error。推测问题可能出在Nginx配置、Dockerfile或Kubernetes部署逻辑中，需要可行的解决思路。

相关配置文件 #

Dockerfile #

FROM node:latest as build
WORKDIR /app
COPY . ./
RUN npm install && npm run build

FROM nginx:stable
RUN apt-get update && apt-get install -y nginx-extras libnginx-mod-http-headers-more-filter
RUN rm /etc/nginx/sites-enabled/default
COPY --from=build /app/build /usr/share/nginx/html
COPY nginx/default.conf /etc/nginx/conf.d/
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

Nginx配置文件（nginx/default.conf） #

server_tokens off;
more_clear_headers 'Server';

server {
  listen 80;
  root /usr/share/nginx/html;
  index index.html index.htm;

  location / {
    try_files $uri $uri/ /index.html;
  }
}

Kubernetes部署文件 #

apiVersion: apps/v1
kind: Deployment
metadata:
  name: frontend-service
spec:
  replicas: 3
  selector:
    matchLabels:
      app: frontend
  template:
    metadata:
      labels:
        app: frontend
    spec:
      containers:
      - name: frontend-container
        image: [REDACTED_FOR_SECURITY]
        ports:
        - containerPort: 80
      imagePullSecrets:
        - name: [REDACTED_FOR_SECURITY]

---
apiVersion: v1
kind: Service
metadata:
  name: frontend-service
spec:
  selector:
    app: frontend
  ports:
  - protocol: "TCP"
    port: 80
    targetPort: 80
  type: LoadBalancer

解决思路 #

1. 优先排查镜像架构不匹配问题 #

exec format error 最常见原因是镜像CPU架构与GKE节点架构不兼容（比如本地用ARM架构Mac构建镜像，GKE节点是x86_64架构）。

• 解决方法：
  • 构建镜像时强制指定x86_64架构，修改Dockerfile的基础镜像声明：

    FROM --platform=linux/amd64 node:latest as build
    # ... 构建阶段代码 ...
    FROM --platform=linux/amd64 nginx:stable
    # ... Nginx阶段代码 ...
    

  • 或使用Docker Buildx构建多架构镜像，推送至仓库后让GKE自动匹配节点架构拉取。

2. 覆盖Nginx默认Entrypoint #

Nginx官方镜像自带docker-entrypoint.sh脚本，若你的CMD与该脚本逻辑冲突，可能触发报错。

• 解决方法：在Nginx阶段显式清空Entrypoint，再指定启动命令：

  FROM --platform=linux/amd64 nginx:stable
  ENTRYPOINT [] # 清空默认entrypoint
  RUN apt-get update && apt-get install -y nginx-extras libnginx-mod-http-headers-more-filter
  # ... 后续配置代码 ...
  CMD ["nginx", "-g", "daemon off;"]
  

3. 检查镜像构建完整性 #

• 本地重新构建镜像，查看完整日志，确认npm install、npm run build、文件COPY等步骤无报错。
• 确保nginx/default.conf文件处于Docker构建上下文路径中，避免COPY失败导致镜像配置缺失。

4. 验证GKE镜像拉取与本地镜像运行 #

• 用kubectl describe pod <pod-name>查看Pod事件，确认镜像是否成功拉取（检查imagePullSecrets配置是否正确）。
• 本地运行镜像测试：docker run --rm -p 8080:80 <你的镜像名>，若本地也报错，说明镜像本身存在问题，需先修复镜像。

内容的提问来源于stack exchange，提问作者Óscar Reina Gustafsson