M3芯片MacBook上Docker中sharp安装失败问题求助

方案1：指定Docker镜像为x86_64架构（利用Rosetta模拟） #

在docker-compose.yml的hfs_platform服务中添加平台指定，让Docker用Rosetta模拟x86_64环境，和旧Intel Mac的运行环境对齐：

services:
  hfs_platform:
    platform: linux/amd64
    # 保留原有其他配置

方案2：修改Dockerfile手动安装符合要求的libvips #

如果不想依赖架构模拟，可在容器构建阶段提前安装指定版本的libvips（以Debian/Ubuntu基础镜像为例）：

# 先安装编译依赖并编译安装libvips 8.11.3
RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    pkg-config \
    libglib2.0-dev \
    libjpeg-dev \
    libpng-dev \
    libwebp-dev \
    libtiff-dev \
    libexif-dev \
    libgsf-1-dev \
    && curl -L https://github.com/libvips/libvips/releases/download/v8.11.3/vips-8.11.3.tar.gz | tar xz \
    && cd vips-8.11.3 \
    && ./configure --prefix=/usr \
    && make && make install \
    && cd .. && rm -rf vips-8.11.3 \
    && apt-get purge -y build-essential pkg-config \
    && apt-get autoremove -y \
    && rm -rf /var/lib/apt/lists/*

# 再执行Node依赖安装
RUN npm install

方案3：升级Sharp版本适配ARM架构 #

如果项目允许，将sharp升级到v0.29.0及以上版本——新版本对ARM架构支持更完善，预编译包已包含适配glibc 2.24的libvips：

RUN npm install sharp@^0.29.0

同时更新package.json中的sharp版本范围。

额外操作建议 #

• 确认Docker Desktop已开启Rosetta模拟：进入设置→Features in development→勾选Use Rosetta for x86/amd64 emulation on Apple Silicon
• 清理旧镜像容器后重新构建：

docker-compose down -v
docker-compose build --no-cache
docker-compose up

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