GitLab CI中Docker命令异常：&&后命令提示docker未找到

核心原因 #

GitLab CI的script段里，用&&这类符号拼接多命令时，容易出现shell环境变量继承异常——虽然单独的docker login能正常执行（runner初始环境包含Docker路径），但拼接后的命令通过eval执行时，后续命令的PATH可能丢失了Docker的路径配置，导致找不到docker命令。

具体修复方法 #

方法1：用Docker绝对路径执行命令 #

先在目标服务器上执行which docker拿到绝对路径（比如/usr/bin/docker），把所有docker命令替换成绝对路径：

script:
  - docker login ...
  - docker pull ...
  - if [ $(/usr/bin/docker ps -q -f name=your-container) ]; then /usr/bin/docker rename your-container your-container-old && /usr/bin/docker stop your-container-old; fi
  - /usr/bin/docker run -d --name your-container your-image:latest

方法2：拆分命令为独立的script步骤 #

不要把多命令用&&挤在一行，拆成独立的script条目，每个条目都会继承runner的完整环境：

script:
  - docker login ...
  - docker pull ...
  - if [ $(docker ps -q -f name=your-container) ]; then docker rename your-container your-container-old; fi
  - if [ $(docker ps -q -f name=your-container-old) ]; then docker stop your-container-old; fi
  - docker run -d --name your-container your-image:latest

方法3：手动重置PATH环境变量 #

在script开头导出包含Docker路径的PATH，确保后续所有命令都能找到docker：

script:
  - export PATH=$PATH:/usr/bin  # 替换成你服务器上docker所在的目录
  - docker login ...
  - docker pull ...
  - if [ $(docker ps -q -f name=your-container) ]; then docker rename your-container your-container-old && docker stop your-container-old; fi
  - docker run -d --name your-container your-image:latest

方法4：强制用bash执行命令块 #

避免sh环境的差异，直接用bash包裹拼接的命令：

script:
  - docker login ...
  - docker pull ...
  - bash -c 'if [ $(docker ps -q -f name=your-container) ]; then docker rename your-container your-container-old && docker stop your-container-old; fi'
  - docker run -d --name your-container your-image:latest

验证小技巧 #

可以在script里加两行命令，对比环境差异：

script:
  - which docker && echo $PATH  # 查看初始环境的docker路径和PATH
  - if [ $(docker ps -q -f name=your-container) ]; then which docker && echo $PATH; fi  # 查看拼接命令里的环境

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