Dockerfile中以普通用户运行pipenv时出现命令找不到错误

问题原因 #

当以普通用户sorted执行pip install pipenv时，pip会将pipenv安装到该用户主目录的~/.local/bin（对应实际路径/home/sorted/.local/bin），而这个路径默认不在系统的PATH环境变量里，导致执行pipenv命令时系统找不到对应的可执行文件。

而以root用户安装时，pip会把包放到全局可访问的/usr/local/bin目录，这个路径默认包含在PATH中，所以能正常调用pipenv。

解决方法 #

方法一：在RUN命令中临时添加PATH #

修改Dockerfile的RUN指令，先把用户本地的bin目录加入PATH，再执行安装和pipenv相关命令：

FROM python:3.9 as builder

RUN useradd -ms /bin/bash sorted
USER sorted

WORKDIR /server/
COPY Pipfile Pipfile.lock /server/

RUN export PATH="$HOME/.local/bin:$PATH" \
    && pip install pipenv --no-cache-dir \
    && pipenv install --system --deploy

COPY . /server/

方法二：用ENV指令永久设置PATH #

如果后续还有其他需要调用用户本地安装包的操作，可以通过ENV指令提前把路径加入环境变量，让所有后续指令都能生效：

FROM python:3.9 as builder

RUN useradd -ms /bin/bash sorted
USER sorted
ENV PATH="/home/sorted/.local/bin:${PATH}"

WORKDIR /server/
COPY Pipfile Pipfile.lock /server/

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

COPY . /server/

补充说明 #

使用pip install --user pipenv可以明确指定安装到用户本地目录，避免权限问题，配合PATH路径的设置就能彻底解决找不到命令的问题。

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