解决GitHub Actions中Docker登录的“非TTY设备无法交互式登录”错误

我尝试通过GitHub Actions搭建CI流水线，构建并推送Docker镜像至Docker Hub，但在Docker登录步骤遇到错误。

我的工作流文件 #

name: Docker Image CI

on:
  push:
    branches: [ "main" ]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Check out the code
        uses: actions/checkout@v4

      - name: Login to Dockerhub
        env:
          DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }}
          DOCKER_PASSWORD: ${{ secrets.DOCKER_PASSWORD }}
        run: echo $DOCKER_PASSWORD | docker login -u $DOCKER_USERNAME --password-stdin

      - name: Build the Docker image
        run: docker build -t sheraz/cicd-pipeline .

      - name: Push to Dockerhub
        run: docker push sheraz/cicd-pipeline:latest

运行时错误信息 #

Run echo $DOCKER_PASSWORD | docker login -u $DOCKER_USERNAME --password-stdin
echo $DOCKER_PASSWORD | docker login -u $DOCKER_USERNAME --password-stdin
shell: /usr/bin/bash -e {0}
env:
  DOCKER_USERNAME:
  DOCKER_PASSWORD:
Error: Cannot perform an interactive login from a non TTY device
Error: Process completed with exit code 1.

问题原因 #

从日志可见DOCKER_USERNAME和DOCKER_PASSWORD环境变量为空，说明GitHub Secrets未被正确加载到工作流中。此时docker login命令缺少有效凭据，会尝试启动交互式登录，但CI环境是非TTY终端，无法支持交互式操作，因此报错。

解决步骤 #

1. 确认GitHub仓库Secrets配置正确 #

• 进入仓库的「Settings」→「Secrets and variables」→「Actions」页面
• 分别创建DOCKER_USERNAME和DOCKER_PASSWORD两个Secret：
  • DOCKER_USERNAME填写你的Docker Hub用户名
  • DOCKER_PASSWORD推荐使用Docker Hub生成的访问令牌（而非账号密码，开启两步验证的账号必须用访问令牌）

2. 优化登录步骤（更安全规范） #

推荐使用官方的docker/login-action替代手动echo密码的方式，该Action针对CI环境优化，避免终端输出泄露风险，修改后的登录步骤如下：

- name: Login to Docker Hub
  uses: docker/login-action@v3
  with:
    username: ${{ secrets.DOCKER_USERNAME }}
    password: ${{ secrets.DOCKER_PASSWORD }}

3. 完善镜像标签与推送命令 #

构建镜像时明确指定latest标签，确保推送命令与标签一致：

- name: Build the Docker image
  run: docker build -t sheraz/cicd-pipeline:latest .

- name: Push to Docker Hub
  run: docker push sheraz/cicd-pipeline:latest

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