Linux系统下Docker Desktop无法挂载hostPath问题排查

1. 补充hostPath的type字段 #

你的YAML配置未声明hostPath的类型，Kubernetes可能无法正确识别本地目录的存在状态，进而自动创建空目录完成挂载。修改volumes部分：

volumes:
- name: api-code
  hostPath:
    path: /home/my-home/repositories/my-project/app/api
    type: Directory  # 明确指定路径为已存在的目录

该字段会让Kubernetes预先验证主机路径是否为有效目录，避免无意义的空目录挂载。

2. 验证Docker Desktop虚拟机的路径映射 #

若你在Windows或macOS上运行Docker Desktop，Kubernetes节点实际是Docker托管的虚拟机，本地主机目录会被映射到虚拟机的特定路径中。即便已将/home加入File sharing，仍需确认映射是否生效：

• 进入Docker Desktop虚拟机终端：
  • macOS：执行 screen ~/Library/Containers/com.docker.docker/Data/vms/0/tty（退出按Ctrl+A+K）
  • Windows：执行 docker run -it --privileged --pid=host debian nsenter -t 1 -m -u -i sh
• 在虚拟机内检查/home/my-home/repositories/my-project/app/api是否存在且包含文件，若不存在需重新核对Docker Desktop的File sharing设置，或调整hostPath路径为虚拟机内的实际映射路径。

3. 排查Pod挂载事件与目录权限 #

• 查看Pod的挂载相关事件，确认是否存在挂载失败提示：

  kubectl describe pod <你的Pod名称>
  

  在输出的Events区域查找权限不足、路径不存在等挂载错误信息。
• 调整本地目录权限，确保Docker进程拥有读取权限：

  chmod -R 755 /home/my-home/repositories/my-project/app/api
  

你的配置在microk8s中正常运行，说明YAML逻辑本身无问题，故障根源在于Docker Desktop的虚拟机环境与本地主机的路径映射差异，或是Kubernetes对hostPath的处理逻辑不同。

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