卷挂载失败:路径未找到
快速摘要
你的容器无法挂载卷 —— 卷映射中指定的主机路径不存在。
为什么发生
卷映射中的主机目录路径不正确或不存在
路径使用在主机上解析方式不同的相对路径
主机路径权限阻止容器访问它
最小示例
✗ 错误代码
# 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
更正卷映射路径以指向现有目录
修复主机目录权限以允许容器用户读写
如何预防
对容器管理的数据使用命名卷而非绑定挂载
在部署脚本中创建所需主机目录后再启动容器