如何在Alpine Docker环境中避免oracledb源码编译以加速CI构建？

针对你遇到的oracledb在musllinux环境下每次都要源码编译、耗时过长的问题，可通过以下几种方案解决：

方案1：拆分oracledb安装，利用Docker层缓存 #

将oracledb从requirements.txt中移除，单独用RUN指令安装，借助Docker的分层缓存特性，只有当oracledb版本变更时才会重新编译：

# 单独安装oracledb，该层仅在版本变更时重新构建
RUN pip install oracledb==3.4.2

# 安装其他通用依赖，此层变更不会触发oracledb的重新编译
RUN pip install -r requirements.txt

这种方式和你之前用cx-Oracle的思路一致，把不常变更的依赖提前安装，最大化利用缓存。

方案2：预编译musllinux版本的oracledb wheel #

由于PyPI没有提供musllinux预编译包，自己编译一次后复用：

1. 本地或临时容器中编译wheel：

docker run --rm -v $(pwd):/work python:3.13-alpine3.23 sh -c "
    apk add gcc g++ musl-dev python3-dev
    pip wheel oracledb==3.4.2 -w /work/wheels
"

2. 将生成的wheel文件上传到GitLab项目的Package Registry（Python包仓库）。
3. 修改Dockerfile，从私有源拉取预编译wheel：

# 从GitLab私有源安装oracledb，直接用预编译包
RUN pip install --extra-index-url https://gitlab.example.com/api/v4/projects/<你的项目ID>/packages/pypi/simple oracledb==3.4.2

RUN pip install -r requirements.txt

这样pip会跳过源码编译，直接下载预编译包，耗时可降至和cx-Oracle时期相当。

方案3：用ccache缓存编译中间文件 #

通过ccache复用编译中间产物，即使需要重新编译也能大幅提速：

1. 在GitLab CI配置中添加ccache缓存：

variables:
  CCACHE_DIR: "$CI_PROJECT_DIR/.ccache"

cache:
  paths:
    - .ccache/

2. 在Dockerfile中配置ccache：

# 安装ccache及编译依赖
RUN apk add ccache gcc g++ musl-dev python3-dev

# 让gcc/g++优先使用ccache
ENV PATH="/usr/lib/ccache:$PATH"

# 安装oracledb和其他依赖
RUN pip install oracledb==3.4.2
RUN pip install -r requirements.txt

ccache会缓存编译生成的目标文件，后续编译时直接复用，能把编译时间从9分钟压缩到几十秒。

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