AWS EKS中PV/PVC挂载NGINX配置文件失效求助

云上老周

2026-5-14

问题排查与解决方案

你遇到的问题在EKS中使用hostPath PV时很常见，主要是因为hostPath依赖节点本地存储，而EKS作为托管集群有一些特殊限制。下面分点帮你逐一排查：

1. 确保Pod调度到存有配置文件的目标节点

hostPath是节点本地存储，只有当Pod运行在你存放/mnt/data文件的那个EC2节点上时，才能挂载到正确的目录。如果Pod被调度到其他节点，挂载的只会是那个节点上的空/mnt/data目录（如果目录不存在，K8s会自动创建空目录）。

解决步骤：

先给存放配置的目标节点打标签，方便Pod精准调度：

# 替换<your-node-name>为实际节点名称，可通过kubectl get nodes查看
kubectl label nodes <your-node-name> nginx-config-source=true

修改NGINX Pod配置，添加nodeSelector字段强制Pod调度到打标签的节点：

apiVersion: v1
kind: Pod
metadata:
  name: task-pv-pod
spec:
  nodeSelector:  # 新增节点选择规则
    nginx-config-source: true
  volumes:
    - name: task-pv-storage
      persistentVolumeClaim:
        claimName: task-pv-claim
  containers:
    - name: task-pv-container
      image: nginx
      ports:
        - containerPort: 80
          name: "http-server"
      volumeMounts:
        - mountPath: "/usr/share/nginx/html"
          name: task-pv-storage

2. 检查节点上`/mnt/data`的权限设置

Nginx容器默认以nginx用户（UID通常为101）运行，如果节点上的/mnt/data目录权限不允许这个用户读取，容器内就看不到文件。

解决步骤：

登录到目标EC2节点（可通过AWS Console的EC2页面连接或SSH），修改目录权限：

# 让nginx用户拥有目录及文件的读写权限
sudo chown -R 101:101 /mnt/data
# 或者至少开放读权限给所有用户
sudo chmod -R 755 /mnt/data

3. 确认PV与PVC已正确绑定

先检查PV和PVC的状态，确保它们成功绑定：

kubectl get pv task-pv-volume
kubectl get pvc task-pv-claim

查看PVC的STATUS是否为Bound，PV的CLAIM字段是否显示default/task-pv-claim（如果在default命名空间）。如果未绑定，Pod会处于Pending状态，需要检查PV和PVC的accessModes、storageClassName、storage请求是否完全匹配。

4. 验证容器内挂载是否生效

进入Pod内部，直接检查挂载状态：

kubectl exec -it task-pv-pod -- bash

在容器内执行以下操作：

查看挂载点：mount | grep /usr/share/nginx/html，如果能看到对应hostPath的挂载记录，说明挂载成功；
检查目录内容：ls -l /usr/share/nginx/html，如果还是空的，回到节点上确认/mnt/data确实有文件，且权限配置正确；
如果没有挂载记录，说明PV/PVC绑定存在问题，或Pod调度到了错误节点。

5. 排除Fargate节点的可能性

如果你的EKS集群使用了Fargate节点组，hostPath是不被支持的——Fargate是无服务器架构，没有持久化的本地节点存储。你需要确保Pod调度到EC2类型的节点组上。

检查方法：

kubectl describe pod task-pv-pod | grep Node-Selector

如果看到eks.amazonaws.com/compute-type: fargate，说明Pod运行在Fargate上，需要切换到EC2节点组。

按照上面的步骤逐一排查，应该能解决文件不显示的问题。

内容的提问来源于stack exchange，提问作者Alexandre Barreiro Neto