LuaJIT使用FFI加载SO库时外部符号未定义问题的解决方法

当通过LuaJIT FFI加载SO库时，若该SO中使用的extern变量实际定义在另一个SO文件中，会触发undefined symbol错误，以下是具体解决思路及针对你的代码的修改方案：

问题代码示例 #

local ffi = require("ffi")

print("start test:")
-- 注：此行对ffi.load直接加载SO无作用，package.cpath用于Lua模块查找
package.cpath = package.cpath .. ";/data/system2.so"

ffi.cdef[[
typedef enum
{
    E_DEBUG_LEVEL_ERR,
    E_DEBUG_LEVEL_WARNING,
    E_DEBUG_LEVEL_NOTICE,
    E_DEBUG_LEVEL_INFO,

    E_DEBUG_LEVEL_MAX
}DebugLevel_E;


typedef enum
{
    COMRET_SUCCESS              = 0,
    COMRET_INTERNAL_ERROR       = 1,
    COMRET_INVALID_ARGUMENTS    = 2,
    COMRET_RESOURCE_EXCEEDED    = 3,
    COMRET_LOCK_TIMEOUT         = 4,
    COMRET_MAX
} ComRet;

typedef void json_object;

extern DebugLevel_E g_eDebugLevel; -- 补充变量类型，原代码缺失

ComRet Reboot(json_object *jsonSend);
]]

-- 先加载包含g_eDebugLevel定义的SO文件，假设为libdebug.so
local debug_lib = ffi.load("/data/libdebug.so", true)
-- 再加载依赖它的system2.so
local example = ffi.load("/data/system2.so", true)

local jsonSend = ffi.new("json_object*") -- 原代码new的是void类型，应改为指针

local ret = example.Reboot(jsonSend)

if ret == ffi.C.COMRET_SUCCESS then
  local jsonString = ffi.string(ffi.C.json_object_to_json_string(jsonSend))
  print("JSON Object content:", jsonString)
else
  print("Reboot failed or invalid return value")
end

具体解决方法 #

1. 优先加载定义extern变量的SO #

这是最直接的解决方案：在加载依赖SO（system2.so）之前，先加载包含extern变量定义的SO文件。动态链接器会将已加载的符号共享给后续加载的库，从而解决符号未定义问题。

• 定位到g_eDebugLevel实际定义的SO文件（比如libdebug.so）
• 用ffi.load先加载该SO，再加载system2.so

2. 修改SO编译链接参数（若有权限修改编译流程） #

如果能控制SO的编译过程，可以在编译system2.so时，将依赖的SO通过静态链接或强制包含符号的方式处理：

• 使用ld的--whole-archive参数链接依赖的SO，确保所有符号被包含进system2.so
• 或者将依赖的SO编译为静态库，再链接到system2.so中

3. 手动定义缺失符号（临时应急方案） #

如果无法加载依赖的SO，可以在LuaJIT中手动定义该extern变量作为临时 workaround，但需注意这会覆盖原变量的实际定义，可能导致逻辑异常：

ffi.cdef[[
extern DebugLevel_E g_eDebugLevel;
]]
-- 手动赋值，比如设为默认级别
ffi.C.g_eDebugLevel = ffi.C.E_DEBUG_LEVEL_INFO

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