MacBook Pro M1（v.12）环境下Laravel Sail（Docker）中Oracle数据库驱动编译失败求助

我刚帮几个朋友解决过类似的M1 Mac + Docker下Oracle驱动编译失败的问题，你的报错核心原因很明确：M1是ARM64架构，而你当前用的Oracle Instant Client是x86_64版本的，导致编译器找不到兼容的libclntsh.so库。下面给你一步步的解决方案：

1. 切换Docker基础镜像为ARM64版本 #

Laravel Sail默认的镜像可能是x86_64的，在M1上会通过Rosetta模拟运行，这会加剧架构不兼容问题。修改你的Dockerfile第一行为ARM64专属镜像：

FROM ghcr.io/laravel/sail/php82-composer:latest-arm64

如果你的PHP版本不同，替换成对应版本的-arm64后缀镜像即可。

2. 准备ARM64版本的Oracle Instant Client #

Oracle已经推出了ARM64架构的Instant Client，你需要先从Oracle官网下载对应版本的压缩包（推荐19.18或21.x版本，确保和你要安装的oci8扩展版本兼容），然后把压缩包放到你的Laravel项目根目录。

3. 修改Dockerfile中的客户端解压与配置 #

在Dockerfile中添加以下步骤，替换原来的x86客户端相关代码：

# 安装依赖工具
RUN apt-get update && apt-get install -y \
    libaio-dev \
    unzip \
    && rm -rf /var/lib/apt/lists/*

# 解压ARM版Oracle Instant Client
ADD ./instantclient-basic-linux.arm64-19.18.0.0.0dbru.zip /tmp/
RUN unzip /tmp/instantclient-basic-linux.arm64-19.18.0.0.0dbru.zip -d /opt/oracle \
    && rm /tmp/instantclient-basic-linux.arm64-19.18.0.0.0dbru.zip

# 配置环境变量，让编译器找到ARM库
ENV LD_LIBRARY_PATH=/opt/oracle/instantclient_19_18:$LD_LIBRARY_PATH
ENV ORACLE_HOME=/opt/oracle/instantclient_19_18

注意：如果下载的是其他版本的客户端，要同步修改压缩包文件名和解压后的目录名（比如instantclient_21_10）。

4. 指定兼容的oci8扩展版本进行安装 #

安装oci8时，明确指定和Instant Client版本匹配的扩展版本（比如oci8-3.2.1兼容19.10+的客户端）：

RUN pecl install oci8-3.2.1 \
    && docker-php-ext-enable oci8

最后验证 #

修改完Dockerfile后，执行以下命令重新构建镜像（避免缓存影响）：

sail build --no-cache

构建完成后启动容器，就能正常使用Oracle驱动了。如果还有问题，可以尝试升级Instant Client到21.x的ARM版本，或者检查环境变量路径是否和实际解压目录一致。

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