Ubuntu 24.04下Ruby执行时llhttp-ffi等Gem扩展未构建警告求助

以下是几种核心成因：

• 权限与环境隔离：用sudo执行gem pristine会将gem修复到系统级Ruby的gem目录，但普通用户运行Ruby/irb时加载的是用户级gem目录，两个目录的gem状态独立，导致系统级修复好的扩展对当前用户不可用。
• 多Ruby环境冲突：系统中同时存在多个Ruby环境（比如系统自带Ruby和rbenv/rvm管理的Ruby），执行gem pristine用的是某一个环境的gem命令，但运行irb时调用的是另一个环境的Ruby，对应环境下的gem扩展并未被修复。
• 隐性系统依赖缺失：虽然安装了基础编译工具，但部分gem的原生扩展需要特定系统开发库（例如llhttp-ffi依赖libllhttp-dev，ox依赖libxml2-dev），编译过程中可能因依赖缺失静默失败，表面显示修复完成但实际扩展未构建成功。
• gem目录权限异常：gem安装目录的文件或文件夹权限错误，导致Ruby运行时无法读取已构建的扩展文件，即使gem pristine执行成功，仍会判定扩展未构建。
• 多版本gem未全部处理：同一gem存在多个版本（如llhttp-ffi的0.5.1和0.4.0），仅修复其中一个版本的扩展，其他版本未处理，运行时仍会触发未构建警告。

快速验证方法 #

1. 检查权限导致的环境隔离：

# 查看当前用户的gem目录
gem env gemdir
# 查看sudo权限下的gem目录
sudo gem env gemdir

若两个路径不同，即可确认是权限导致的环境隔离问题。

2. 检查多Ruby环境冲突：

# 查看当前用户使用的Ruby路径
which ruby
# 查看sudo权限下的Ruby路径
sudo which ruby

若路径不一致，说明存在多Ruby环境冲突。

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