运行docker-compose时Service 'web'构建失败：pip无--system参数报错

• 核心构建错误和pip版本高低无关，属于命令参数错配：--system是pipenv install命令的参数，作用是跳过虚拟环境创建，直接把依赖安装到当前系统Python环境中；原生pip命令不存在这个参数，你写的pip install --system属于非法调用，直接触发参数不存在报错，返回退出码2，直接终止构建流程。
• 后续连续抛出的bash: ERROR:: command not found是前序命令崩溃引发的连锁异常：pip命令执行失败后，Docker构建上下文的shell流处理异常，把后续输出的错误日志文本误当成待执行的bash命令解析，才会重复报命令不存在，该问题不需要单独修复，修正前序的依赖安装命令后会自动消失。

• 修正Dockerfile中的依赖安装命令
  把原有错误的配置行：

  RUN pip install pipenv && pip install --system
  

  替换为正确的pipenv调用写法：

  RUN pip install --no-cache-dir pipenv && pipenv install --system --deploy
  

  相关参数作用：
  • --no-cache-dir：安装pipenv时跳过包缓存，减小镜像体积
  • --deploy：强制校验Pipfile与Pipfile.lock的版本一致性，避免依赖版本漂移
    如果你没有用pipenv管理依赖的需求，直接删掉pipenv相关逻辑，改用原生pip安装requirements.txt即可，写法参考：

  RUN pip install --no-cache-dir -r requirements.txt
  

• 补充PostgreSQL依赖安装步骤（Django连接PostgreSQL必需）
  在Dockerfile的依赖安装段最前面，加一行安装系统编译依赖，否则后续安装psycopg2会报编译失败：

  RUN apt-get update && apt-get install -y --no-install-recommends gcc libpq-dev && rm -rf /var/lib/apt/lists/*
  

• 清除旧构建缓存后重新启动
  执行以下命令清除之前失败的构建缓存，再重新启动服务即可：

  docker-compose build --no-cache web
  docker-compose up
  

• 确认docker-compose.yml中web服务配置了对PostgreSQL服务的依赖，添加depends_on字段关联你的PostgreSQL服务，避免Django启动时数据库还未完成初始化。
• 确认Django的settings.py里的数据库配置指向docker-compose中定义的PostgreSQL服务名，不要写localhost，否则容器内无法连通数据库。

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