在Docker中安装unzip用于Airflow时出现命令未找到错误

Exit code 127表示系统找不到unzip命令，即便你在Dockerfile里加了安装命令，大概率是安装过程未生效或镜像未更新，以下是具体排查步骤：

1. 修正Dockerfile中的安装命令 #

很多基础镜像的APT源默认未更新，直接执行apt-get install unzip可能因找不到包导致安装失败（无显性报错但实际未装上）。修改Dockerfile为：

RUN apt-get update && apt-get install -y --no-install-recommends unzip \
    && rm -rf /var/lib/apt/lists/*

• apt-get update：更新APT源索引，确保能找到unzip包
• -y：自动确认安装，避免构建镜像时卡住
• --no-install-recommends：减少不必要的依赖安装，缩小镜像体积
• rm -rf ...：清理APT缓存，避免镜像体积过大

2. 重新构建并部署镜像 #

修改Dockerfile后，必须重新构建镜像并重启Airflow服务，否则容器仍会使用旧的未安装unzip的镜像：
如果使用docker-compose：

# 重新构建相关镜像
docker-compose build
# 重启Airflow服务
docker-compose up -d

3. 验证容器内是否真的安装了unzip #

任务实际在Airflow Worker容器中执行，进入容器确认unzip是否存在：

# 替换为你的worker容器名称，比如airflow-worker
docker exec -it airflow-worker bash
# 检查unzip的安装路径
which unzip

若输出/usr/bin/unzip，说明安装成功；若无输出，查看镜像构建日志，确认安装过程是否有报错。

4. 改用绝对路径执行unzip #

如果容器内已安装unzip但仍报127，可能是Airflow执行环境的PATH变量未包含/usr/bin，直接用绝对路径执行即可：

unzip_dataset_task = BashOperator(
    task_id="unzip_dataset_task",
    bash_command=f"/usr/bin/unzip -o {path_to_local_home}/{dataset_zip} -d {path_to_local_home}",
)

5. 适配Airflow架构场景 #

• 若使用CeleryExecutor：确保Worker节点的镜像和你修改的Dockerfile一致，不要只更新Webserver/Scheduler的镜像
• 若使用KubernetesExecutor：确保Pod模板使用的是更新后的镜像，或在Pod启动脚本中添加unzip安装命令

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