Ubuntu 16.04 Docker镜像部署Python3.8启动报错及优化咨询

一、解决"exec: 'python': executable file not found in $PATH"错误 #

编译安装Python3.8后，Ubuntu 16.04系统默认不会自动创建python软链接，且若编译时未指定正确路径，可能导致Python的bin目录未加入系统PATH。可通过以下两种方式修复：

1. 编译时指定路径并创建软链接 #

修改Dockerfile的Python编译步骤，确保安装到系统可识别路径，并创建python指向python3.8的软链接：

# 安装编译依赖
RUN apt-get update && apt-get install -y build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev wget

# 下载并编译Python3.8
RUN wget https://www.python.org/ftp/python/3.8.18/Python-3.8.18.tgz && \
    tar -xf Python-3.8.18.tgz && \
    cd Python-3.8.18 && \
    ./configure --prefix=/usr/local --enable-optimizations && \
    make -j$(nproc) && \
    make install

# 创建python、pip软链接
RUN ln -s /usr/local/bin/python3.8 /usr/bin/python && \
    ln -s /usr/local/bin/pip3.8 /usr/bin/pip

/usr/local/bin默认在系统PATH中，这样python命令就能直接指向Python3.8。

2. 手动追加PATH并创建软链接 #

若不想修改编译步骤，可在Dockerfile末尾添加：

# 将Python安装目录加入PATH
ENV PATH="/usr/local/bin:${PATH}"
# 创建python软链接
RUN ln -s /usr/local/bin/python3.8 /usr/local/bin/python

二、加速Ubuntu 16.04镜像构建的方法 #

Ubuntu 16.04已停止官方支持，默认源速度慢，加上编译Python耗时，可通过以下方式优化：

1. 替换为国内归档源 #

Ubuntu 16.04的官方源已迁移到归档服务器，替换为国内镜像站的归档源，加速依赖安装：

# 替换为Ubuntu官方归档源
RUN sed -i 's/archive.ubuntu.com/old-releases.ubuntu.com/g' /etc/apt/sources.list && \
    sed -i 's/security.ubuntu.com/old-releases.ubuntu.com/g' /etc/apt/sources.list

# 或者替换为清华归档源
RUN echo "deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu-archive xenial main restricted universe multiverse" > /etc/apt/sources.list && \
    echo "deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu-archive xenial-updates main restricted universe multiverse" >> /etc/apt/sources.list && \
    echo "deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu-archive xenial-backports main restricted universe multiverse" >> /etc/apt/sources.list

2. 分层构建利用Docker缓存 #

把依赖安装、Python编译、项目依赖、代码复制拆分为独立层，避免每次修改代码都重新编译Python：

# 基础镜像层
FROM ubuntu:16.04

# 替换源层
RUN sed -i 's/archive.ubuntu.com/old-releases.ubuntu.com/g' /etc/apt/sources.list

# 安装编译依赖层
RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential zlib1g-dev libncurses5-dev libgdbm-dev \
    libnss3-dev libssl-dev libreadline-dev libffi-dev wget \
    unixodbc-dev && \
    rm -rf /var/lib/apt/lists/*

# 编译安装Python层
RUN wget https://www.python.org/ftp/python/3.8.18/Python-3.8.18.tgz && \
    tar -xf Python-3.8.18.tgz && \
    cd Python-3.8.18 && \
    ./configure --prefix=/usr/local --enable-optimizations && \
    make -j$(nproc) && \
    make install && \
    ln -s /usr/local/bin/python3.8 /usr/bin/python && \
    ln -s /usr/local/bin/pip3.8 /usr/bin/pip && \
    rm -rf /Python-3.8.18*

# 安装MSSQL ODBC驱动层
RUN curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add - && \
    curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list > /etc/apt/sources.list.d/mssql-release.list && \
    apt-get update && \
    ACCEPT_EULA=Y apt-get install -y msodbcsql17 && \
    rm -rf /var/lib/apt/lists/*

# 项目依赖层
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 项目代码层
COPY . .
CMD ["echo", "$PATH"]

只要前面的层未修改，Docker会直接复用缓存，大幅减少构建时间。

3. 预下载Python源码包 #

若网络不稳定，可提前下载Python-3.8.18.tgz到本地，通过COPY指令复制到镜像中，避免重复下载：

COPY Python-3.8.18.tgz /
RUN tar -xf Python-3.8.18.tgz && \
    cd Python-3.8.18 && \
    ./configure --prefix=/usr/local --enable-optimizations && \
    make -j$(nproc) && \
    make install

4. 启用Docker BuildKit加速构建 #

在Windows的Docker Desktop中开启BuildKit：

• 打开Docker Desktop设置，进入"Features in development"，勾选"Enable BuildKit"
• 或构建时使用命令：DOCKER_BUILDKIT=1 docker build -t your-image-name .
  BuildKit支持并行构建、智能缓存，能显著提升构建速度。

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