在php-nginx:7.4-alpine Docker镜像中安装Node.js14.18.1失败如何解决

错误原因 #

webdevops/php-nginx:7.4-alpine 基础镜像对应的Alpine发行版默认软件源仅提供Node.js 12.x版本的安装包，直接通过apk add指定14.18.1版本时，源内不存在对应版本的包，因此触发依赖约束不满足的报错。

解决方案 #

方案一：使用Node.js官方预编译二进制包安装（推荐） #

Alpine系统使用musl libc，可直接下载对应版本的预编译二进制包部署，无需依赖Alpine源的包版本：

FROM webdevops/php-nginx:7.4-alpine

# 安装临时工具、下载解压Node.js 14.18.1
RUN apk add --no-cache curl tar && \
    curl -fsSL https://nodejs.org/dist/v14.18.1/node-v14.18.1-linux-x64-musl.tar.gz | tar xz -C /usr/local --strip-components=1 && \
    node -v && npm -v && \
    # 清理冗余文件缩小镜像体积
    apk del curl tar

WORKDIR /var/www/html

该方案不会改动系统软件源，也不会出现依赖冲突问题，适配性最高。

方案二：添加包含目标Node版本的Alpine源安装 #

如果不想使用外部二进制包，可临时添加包含Node.js 14.18.1的Alpine版本源进行安装：

FROM webdevops/php-nginx:7.4-alpine

# 临时添加Alpine v3.16源（该版本源包含Node.js 14.18.1安装包）
RUN echo "http://dl-cdn.alpinelinux.org/alpine/v3.16/main" >> /etc/apk/repositories && \
    echo "http://dl-cdn.alpinelinux.org/alpine/v3.16/community" >> /etc/apk/repositories && \
    apk update && \
    apk add --no-cache nodejs=14.18.1-r0 npm && \
    # 移除新增源，避免后续安装其他软件出现版本冲突
    sed -i '$d' /etc/apk/repositories && sed -i '$d' /etc/apk/repositories

WORKDIR /var/www/html

该方案依赖Alpine源的包版本，存在小概率的底层依赖冲突风险。

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