Passenger在AlmaLinux 9上的编译问题及解决方案

问题背景

在AlmaLinux 9操作系统上编译Passenger 6.0.22时，开发人员遇到了编译失败的问题。错误信息显示编译器无法生成可执行文件，并提示需要先安装开发工具。这个问题在最小化安装环境中尤为常见，特别是在禁用了弱依赖安装的情况下。

错误现象

当尝试在AlmaLinux 9（ARM64架构）上编译Passenger时，会出现以下关键错误：

The compiler failed to generate an executable file. (RuntimeError)
You have to install development tools first.

错误发生在Ruby的mkmf.rb尝试检查头文件时，表明基本的开发环境配置存在问题。

根本原因分析

经过测试发现，问题的根源在于缺少redhat-rpm-config软件包。这个包在RedHat系发行版中提供了关键的编译配置，特别是包含了redhat-hardened-cc1等必要的编译工具链组件。

在默认安装情况下，系统会自动安装这些弱依赖项。但当使用--setopt=install_weak_deps=False参数进行最小化安装时，这些关键组件会被忽略，导致编译环境不完整。

解决方案

有两种方法可以解决这个问题：

1. 允许安装弱依赖：在安装系统包时不使用--setopt=install_weak_deps=False参数，让系统自动安装必要的依赖项。

2. 显式安装redhat-rpm-config：在安装其他开发工具的同时，明确添加这个关键包：

   dnf install redhat-rpm-config gcc gcc-c++ libcurl-devel openssl-devel pcre2-devel ruby-devel zlib-devel
   

技术细节

redhat-rpm-config软件包在RedHat系发行版中扮演着重要角色，它提供了：

• 标准的编译标志和选项
• 系统特定的头文件位置配置
• 安全加固的编译器配置
• RPM构建所需的各种宏定义

特别是在AlmaLinux/RHEL 9中，这个包提供的redhat-hardened-cc1组件是现代安全编译的基础，缺少它会导致基本的编译工具链无法正常工作。

最佳实践建议

对于生产环境中的Passenger部署，建议：

1. 总是确保完整的开发环境，包括redhat-rpm-config
2. 在Docker等容器环境中构建时，明确列出所有依赖项
3. 考虑使用Passenger的预编译包或官方仓库来避免编译问题
4. 在最小化安装环境中，务必测试编译过程是否完整

总结

Passenger在AlmaLinux 9上的编译问题主要源于最小化安装环境缺少关键的系统配置包。通过理解RedHat系发行版的包依赖关系，特别是redhat-rpm-config的作用，可以有效地解决这类编译环境配置问题。这不仅是Passenger特有的问题，也是所有需要在RHEL系发行版上进行源代码编译的软件需要注意的通用问题。