首页/云/Docker 容器速查/退出码 127:找不到命令
本包目录(366 条)
基础命令50 条镜像与构建107 条网络与存储52 条Compose 编排55 条资源与安全50 条
容器排障52 条

退出码 127:找不到命令

127 表示容器内找不到要执行的命令:镜像里没装、PATH 里没有、或 entrypoint 的 shebang 指向不存在的解释器。

Docker 容器速查云更新于 2026-10-12
含义命令不存在(容器内)
排查command -v / 检查 shebang / 看 PATH
常见基础镜像换发行版后命令名或路径变化

示例

示例
docker run --rm alpine curl --version
docker run --rm --entrypoint sh alpine -c 'command -v curl || echo missing; echo $PATH'
docker run --rm --entrypoint sh alpine -c 'head -1 /docker-entrypoint.sh'
区分 Docker 层的 127(命令找不到)与 ssh/应用约定返回的 255,别混用判断逻辑。

易错点

  • 宿主上命令可用不代表容器里可用,镜像的 PATH 与包集合是另一套
  • shebang 写成 #!/bin/bash 但镜像是 alpine(只有 sh)时同样报 127 类错误

数据来源与参考

  • Docker 官方文档:docker run Exit status(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌