GitLab流水线脚本变量解析异常：Docker登录密码特殊字符问题

核心原因 #

• Shell语法解析干扰特殊字符：直接使用$LOGIN_PASSWORD时，密码里的>、~等特殊字符会被Shell当成语法符号（比如>是重定向指令），导致命令参数被错误解析，最终登录失败。
• 变量值加引号无效的本质：在GitLab变量设置里给密码加引号后，引号会被当成密码的一部分传递给Shell，而非作为Shell的引用符号使用，所以无法起到转义特殊字符的作用。

解决办法 #

• 脚本内用单引号包裹变量：让Shell将变量值视为纯字符串，不解析其中的特殊字符：

  build_image:
    before_script:
      - docker login -u '$LOGIN_USER' -p '$LOGIN_PASSWORD'
  

• 双大括号+双引号包裹变量：确保变量正确展开的同时，让Shell将整个变量值作为单个参数传递：

  build_image:
    before_script:
      - docker login -u "${LOGIN_USER}" -p "${LOGIN_PASSWORD}"
  

• 注意：GitLab变量设置中只需填写原始密码，不要添加任何引号，引号仅需在CI脚本的命令中使用。

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