问题背景 #

自2025年5月12日起，基于python:3.11-alpine的Docker镜像中，使用pip安装私有Python包gpf-common-point-cloud时持续失败。即便回退到该包的旧版本，问题依旧存在。错误核心为编译pyproj的Cython文件pyproj/_geod.pyx时触发：

Unsafe C derivative of temporary Python reference used in conditional expression

该包在基于Ubuntu 22的condaforge/mambaforge:latest镜像中可正常安装。

关键错误堆栈片段 #

Error compiling Cython file:
------------------------------------------------------------
...
    def __init__(self, double a, double f, bint sphere, double b, double es):
        geod_init(&self._geod_geodesic, <double> a, <double> f)
        self.a = a
        self.f = f
        # convert 'a' only for initstring
        a_str = int(a) if a.is_integer() else a
                ^
------------------------------------------------------------

pyproj/_geod.pyx:94:16: Unsafe C derivative of temporary Python reference used in conditional expression

涉及的Dockerfile核心配置 #

FROM python:3.11-alpine

RUN apk add --no-cache gcc musl-dev linux-headers python3-dev libstdc++ \
    g++ geos-dev proj-dev proj-util gdal pdal-dev pdal

原因分析 #

1. libc差异：Alpine采用musl libc，而Ubuntu使用glibc，两者内存管理逻辑存在差异，导致旧版pyproj的Cython代码在musl环境下触发引用安全检查报错。
2. 源码编译触发：pip在Alpine环境下未拉取到pyproj的预编译musllinux wheel包， fallback到源码编译，而旧版pyproj源码未适配musl环境的Cython检查规则。

解决方案 #

1. 强制使用预编译musllinux wheel #

通过pip参数强制安装预编译包，避免源码编译：

pip install pyproj>=3.7.1 --only-binary pyproj

或在requirements文件中添加约束：

pyproj>=3.7.1 --only-binary=:all:

2. 升级Cython至兼容版本 #

旧版本Cython对musl环境的临时引用检查过于严苛，升级到最新稳定版可绕过该问题：

pip install --upgrade cython

建议在Dockerfile的依赖安装步骤前执行此命令。

3. 替换为基于glibc的Alpine镜像 #

使用第三方维护的glibc兼容Alpine镜像，减少libc差异导致的问题：

FROM frolvlad/alpine-python3:3.11

4. 固定pyproj为已修复问题的版本 #

检查pyproj版本日志，选择已修复musl编译问题的版本（如3.7.1及以上），在requirements中明确指定：

pyproj==3.7.1

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