如何在FreeBSD中通过Ruby的exec()运行Linux二进制文件？

问题分析 #

核心问题是FreeBSD的Linux兼容层在Ruby exec()调用中未正确触发，导致程序加载了FreeBSD本地的libpng16.so.16而非Linux兼容层对应的库，触发ELF ABI无效错误。Shell环境中能正常运行是因为Shell会自动处理兼容层的环境变量和链接器跳转，但Ruby的exec()直接调用系统调用，缺少这些前置处理。

解决方案 #

1. 强制使用Linux动态链接器启动 #

直接调用FreeBSD Linux兼容层的64位动态链接器来执行wkhtmltopdf，绕过系统自动检测的问题：

# Ruby代码示例
exec '/compat/linux/lib64/ld-linux-x86-64.so.2', '/usr/local/bin/wkhtmltopdf', '--你的参数'

这个方法直接指定用Linux的链接器加载程序，确保所有依赖库都从/compat/linux路径下查找。

2. 确认Linux兼容层配置完整 #

• 检查/etc/rc.conf中是否包含linux_enable="YES"，如果没有添加后重启系统，或临时加载模块：

  kldload linux64
  

• 确保安装了完整的Linux基础库包：

  pkg install linux_base-c7
  

3. 传递Linux兼容层环境变量 #

Ruby的exec()默认继承当前进程的环境变量，可能缺少Linux兼容层需要的路径配置。手动设置环境变量后再执行：

# 构建兼容Linux的环境变量
linux_env = ENV.to_h.merge(
  'LD_LIBRARY_PATH' => '/compat/linux/usr/lib64:/compat/linux/lib64',
  'PATH' => '/compat/linux/bin:/compat/linux/usr/bin:' + ENV['PATH']
)

# 带环境变量执行
exec linux_env, '/usr/local/bin/wkhtmltopdf', '--你的参数'

4. 验证二进制文件类型 #

确认wkhtmltopdf确实是Linux x86-64格式的ELF文件：

file /usr/local/bin/wkhtmltopdf

输出应包含ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked字样，确保不是FreeBSD版本的二进制文件。

为什么/compat/linux/bin/bash -c无效？ #

这种方式失败通常是因为bash继承了Ruby进程的环境变量，LD_LIBRARY_PATH未正确指向Linux兼容层路径，导致程序依然优先加载FreeBSD本地库。通过上述直接指定链接器或手动设置环境变量的方式可以解决这个问题。

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