宿主机路径不存在是Docker绑定挂载启动失败最常见原因，需确认-v左边路径真实存在、具读写权限且为绝对路径；用ls -d检查，不存在则mkdir -p创建，再验证权限与语法。
宿主机路径不存在是 docker 绑定挂载启动失败最常见、也最容易被忽略的原因。容器根本不会启动，直接报错退出，比如 no such file or directory、does not exist: /host_mnt/xxx 或日志里出现 invalid argument。排查关键不是看容器有没有起来，而是确认宿主机上那个“左边的路径”是否真实存在、可访问。
第一步：确认 -v 左边的路径是否真的存在
Docker 的 -v 语法是 -v 主机路径:容器路径，冒号左边必须是宿主机上一个**已创建、有读写权限、且是绝对路径**的目录。Docker 不会自动创建它，也不会提示“我帮你建了”，而是静默失败或直接报错。
- 运行
ls -d /your/host/path（把/your/host/path换成你命令里冒号前的实际路径） - 如果返回
No such file or directory，说明路径压根没建 - 立即执行
mkdir -p /your/host/path创建（-p可递归建父目录） - 特别注意：不能用
./data、~/config或data这类相对路径，必须以/开头
第二步：检查路径权限和归属
路径存在 ≠ 能挂载。Docker 守护进程（通常是 root）需要对这个目录有读、写、执行（进入）权限。
- 运行
ls -ld /your/host/path查看权限和属主 - 常见问题：目录属主是你自己的用户，但权限是
drwx------（700），root 进不去 - 临时验证可用：
sudo chmod 755 /your/host/path - 更稳妥做法：
sudo chown $USER:docker /your/host/path，并确保当前用户在docker组里
第三步：验证挂载语法和上下文
错误常藏在细节里，比如路径拼写、大小写、空格，或者 Compose 文件里用了相对路径却没注意当前工作目录。
- 在
docker run命令中，优先用$(pwd)/relative/path展开为绝对路径，而不是直接写./relative/path - 在
docker-compose.yml中，volumes:下推荐用./config:/app/config这种写法——这里的./是相对于docker-compose.yml所在目录，不是你当前终端位置 - 进容器后第一件事不是跑服务，而是
ls -l /container/mount/path，看里面是不是空的；再对比宿主机上对应路径内容是否一致
第四步：从日志和退出状态快速定位
别靠猜，用 Docker 自带的线索说话。
- 运行
docker ps -a，找刚尝试启动又退出的容器，看 STATUS 是否是Created（根本没启动）或Exited (1)等非零退出码 - 执行
docker logs <容器名或ID>，重点看最后一两行有没有明确路径报错，比如open /config/app.yaml: no such file - 如果日志为空，大概率是挂载阶段就失败了，还没走到 CMD 执行，这时候 90% 是宿主机路径问题
