Skip to content

卷挂载失败:路径未找到

快速摘要

你的容器无法挂载卷 —— 卷映射中指定的主机路径不存在。

为什么发生

  • 卷映射中的主机目录路径不正确或不存在

  • 路径使用在主机上解析方式不同的相对路径

  • 主机路径权限阻止容器访问它

最小示例

✗ 错误代码
# docker-compose.yml
services:
  db:
    image: postgres:15
    volumes:
      - ./data/pg:/var/lib/postgresql/data # ./data/pg does not exist
✓ 修复代码
# docker-compose.yml
services:
  db:
    image: postgres:15
    volumes:
      - pg_data:/var/lib/postgresql/data # named volume — auto-created
volumes:
  pg_data:

使用命名卷而非绑定挂载让 Docker 自动创建和管理卷,避免路径问题。

如何诊断

  • 用主机上的 ls 或 test -d 验证主机路径存在

  • 检查 docker-compose 中卷映射的路径语法是否正确

  • 检查容器日志中与挂载相关的错误消息

如何修复

  • 启动容器前创建主机目录:mkdir -p /path/to/dir

  • 更正卷映射路径以指向现有目录

  • 修复主机目录权限以允许容器用户读写

如何预防

  • 对容器管理的数据使用命名卷而非绑定挂载

  • 在部署脚本中创建所需主机目录后再启动容器

相关资源

相关术语

相关课程

← 返回语言