AlmaLinux 8下RPM Specfile NodeJS依赖版本解析异常求助

问题背景 #

我用NodeJS 18开发了一个应用，正在为AlmaLinux 8制作对应的RPM包，spec文件里的依赖配置如下：

BuildRequires:         nodejs >= 18.18.2
Requires:              nodejs >= 18.18.2

但在全新的AlmaLinux 8服务器上安装这个RPM时，系统会自动安装NodeJS 10版本——原因是DNF默认启用的是nodejs的10模块：

# dnf module list nodejs
Last metadata expiration check: 0:27:46 ago on Fri 16 Feb 2024 01:11:33 PM UTC.
AlmaLinux 8 - AppStream
Name     Stream   Profiles                                Summary
nodejs   10 [d]   common [d], development, minimal, s2i   Javascript runtime
nodejs   12       common [d], development, minimal, s2i   Javascript runtime
nodejs   14       common [d], development, minimal, s2i   Javascript runtime
nodejs   16       common [d], development, minimal, s2i   Javascript runtime
nodejs   18       common [d], development, minimal, s2i   Javascript runtime
nodejs   20       common [d], development, minimal, s2i   Javascript runtime

Hint: [d]efault, [e]nabled, [x]disabled, [i]nstalled

检查RPM依赖发现，自动依赖检测额外添加了/usr/bin/node的依赖：

# rpm -q --requires my_app.rpm
/usr/bin/bash
/usr/bin/node
nodejs >= 18.18.2
rpmlib(CompressedFileNames) <= 3.0.4-1
rpmlib(FileDigests) <= 4.6.0-1
rpmlib(PayloadFilesHavePrefix) <= 4.0-1
rpmlib(PayloadIsXz) <= 5.2-1

我试过在spec文件里加AutoReqProv: no移除/usr/bin/node的依赖，也试过添加Conflicts: nodejs < 18，都没能解决问题。现在想触发如下的错误提示：

All matches were filtered out by modular filtering for argument: nodejs-18.18.2
Error: Unable to find a match: nodejs-18.18.2

解决方法 #

要触发这个错误，核心是让DNF明确找不到满足版本要求的包，需要强制依赖模块化的NodeJS包格式，而不是普通的RPM依赖，具体操作如下：

1. 修改spec文件的依赖配置，替换原有的Requires为模块化依赖格式：

   AutoReqProv: no
   Requires:              module(nodejs:18)
   Requires:              nodejs >= 18.18.2
   

   或者更严格的写法，直接绑定模块流和版本：

   AutoReqProv: no
   Requires:              nodejs:18 >= 18.18.2
   

2. 必须保留AutoReqProv: no，避免自动生成/usr/bin/node的文件依赖——这个依赖会让DNF通过默认的10模块来满足，忽略版本要求。

修改后，当用户在默认启用nodejs 10模块的系统上安装时，DNF会尝试查找nodejs:18流的包，但该流未启用，就会触发你想要的错误提示，明确告知用户需要先启用NodeJS 18模块才能安装。

如果需要给用户更友好的提示，可以在spec中添加post安装提示：

%post
echo "请先启用NodeJS 18模块后再安装：dnf module enable nodejs:18"

原理说明 #

AlmaLinux 8的NodeJS是通过DNF模块分发的，普通的nodejs >=18依赖会被DNF解析为“在当前启用的模块流中寻找满足版本的包”。由于默认流是10，DNF会安装10版本来满足/usr/bin/node的文件依赖，直接忽略你的版本要求。而指定module(nodejs:18)或nodejs:18 >=18.18.2会强制DNF去查找18流的包，当前未启用该流的情况下，就会触发找不到匹配的错误。

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