Apple M2芯片环境下Docker构建容器时pecl安装oci8-2.2.0失败

问题背景 #

Dockerfile在Windows x86环境下正常运行，但在Apple M2芯片环境执行docker-compose up时，构建OCI8扩展步骤报错：

ERROR [web 11/54] RUN echo 'instantclient,/usr/lib/oracle/21.1/client64/lib' | pecl install oci8-2.2.0 7.0s

核心错误信息：

/usr/bin/ld: skipping incompatible /usr/lib/oracle/21.1/client64/lib/libclntsh.so when searching for -lclntsh
/usr/bin/ld: cannot find -lclntsh
collect2: error: ld returned 1 exit status
make: *** [Makefile:209: oci8.la] Error 1
ERROR: `make' failed

错误原因 #

使用了x86_64架构的Oracle Instant Client，而Apple M2是ARM64（aarch64）架构，即使开启Rosetta，编译扩展时链接器无法识别不兼容的x86库文件，导致构建失败。

解决步骤 #

1. 替换为ARM64版本的Oracle Instant Client #

Oracle官方提供了ARM64版本的Instant Client，需替换Dockerfile中的安装包：

• 下载对应版本的instantclient-basic-linux.aarch64-21.4.0.0.0dbru.zip和instantclient-sdk-linux.aarch64-21.4.0.0.0dbru.zip
• 更新Dockerfile中的ADD指令：

ADD docker/conf/oracle/instantclient-basic-linux.aarch64-21.4.0.0.0dbru.zip /tmp/
ADD docker/conf/oracle/instantclient-sdk-linux.aarch64-21.4.0.0.0dbru.zip /tmp/

2. 优化OCI8构建的环境变量 #

在执行pecl install前，明确设置环境变量，确保构建过程正确识别ARM64库路径：

RUN pecl channel-update pecl.php.net && \
    export LD_LIBRARY_PATH=/usr/lib/oracle/21.1/client64/lib && \
    export ORACLE_HOME=/usr/lib/oracle/21.1/client64/lib && \
    echo 'instantclient,/usr/lib/oracle/21.1/client64/lib' | pecl install oci8-2.2.0

3. 适配PDO_OCI的ARM架构构建 #

若PDO_OCI构建仍有问题，在configure时添加ARM架构指定参数：

RUN cd /tmp/pdo_oci && \
    phpize && \
    ./configure --build=aarch64-linux-gnu --with-pdo-oci=instantclient,/usr/lib/oracle/21.1/client64/lib && \
    make install

4. 配置Docker Compose的平台参数 #

在docker-compose.yml中明确指定服务使用ARM64平台，避免架构混淆：

services:
  web:
    platform: linux/arm64/v8
    # 其他原有配置...

已尝试方法的补充说明 #

之前尝试的Rosetta是让x86容器在M2上运行，但编译扩展需要对应架构的依赖库，所以仅靠Rosetta无法解决链接库不兼容的根本问题，必须替换为ARM版Instant Client。

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