Google Cloud Workstation中Python 3.10.7无法导入_bz2模块问题

问题根源 #

你遇到的核心问题是：基础镜像自带的Python是预先编译完成的，编译过程中未链接libbz2库。虽然你安装了bzip2和libbz2-dev，但这些仅为编译依赖，无法让已存在的预编译Python自动获得bz2模块支持。另外你本地验证的是bzip2命令行工具的存在，并未检查Python的bz2模块，因此提前没发现问题。

解决方案 #

方案1：安装系统包管理的完整Python（推荐）

基础镜像基于Debian/Ubuntu体系，直接通过包管理器安装带全模块支持的Python，覆盖或补充现有版本：
在Dockerfile中添加以下指令：

# 安装包含bz2模块的完整Python环境
RUN apt-get update && apt-get install -y --no-install-recommends \
    python3-full \
    python3-pip \
    && rm -rf /var/lib/apt/lists/*

python3-full包会包含Python标准库的所有模块（包括bz2），确保导入不会报错。

方案2：重新编译Python以支持bz2

如果需要特定版本的Python或必须源码编译，按以下步骤操作：

1. 安装完整编译依赖：

RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    libbz2-dev \
    zlib1g-dev \
    libssl-dev \
    libreadline-dev \
    libsqlite3-dev \
    wget \
    && rm -rf /var/lib/apt/lists/*

2. 下载并编译指定版本的Python（以3.10.7为例）：

# 下载Python源码包并编译
RUN wget https://www.python.org/ftp/python/3.10.7/Python-3.10.7.tgz \
    && tar xzf Python-3.10.7.tgz \
    && cd Python-3.10.7 \
    # 配置编译选项，明确启用bz2支持
    && ./configure --enable-optimizations --with-bz2 \
    && make -j$(nproc) \
    && make altinstall \
    # 清理临时文件
    && cd .. && rm -rf Python-3.10.7.tgz Python-3.10.7

编译完成后，使用python3.10调用该版本，即可正常导入bz2模块。

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