Rust调用LLVM C绑定ORC JIT：LLVMOrcGetSymbolAddress无法找到函数符号

嘿，我之前折腾ORC JIT的C绑定的时候也踩过一模一样的坑——明明函数在模块里确确实实存在，就是找不到符号。咱们一步步来排查可能的原因：

1. 先确认你找的符号名和IR里的完全一致 #

LLVM IR里的函数名有时候会和你以为的不一样：比如手动写IR时不小心加了下划线、大小写写错，或是从其他语言生成的IR自带符号mangling，都会导致查找失败。

你已经用LLVMGetNamedFunction确认了函数存在，那不如直接把这个函数的实际符号名打印出来看看：

unsafe {
    let run_func = LLVMGetNamedFunction(module, b"run\0".as_ptr());
    let func_name_cstr = LLVMPrintValueToString(run_func);
    let func_name = String::from_utf8_lossy(CStr::from_ptr(func_name_cstr).to_bytes());
    println!("IR中函数的实际名称: {}", func_name);
    LLVMDisposeMessage(func_name_cstr);
}

比如有时候IR里的函数会被自动加上_前缀（比如_run），如果是Rust生成的IR，符号名甚至会被mangle成一串复杂字符。找到实际名称后，用这个准确名称去调用LLVMOrcGetSymbolAddress试试。

2. 检查模块是否真的被正确添加到JIT里 #

就算函数在模块里，如果模块没被成功添加到ORC JIT的编译实例中，JIT肯定找不到它。一定要确认添加模块的调用没有出错：

unsafe {
    let add_result = LLVMOrcLLJITAddIRModule(jit, module_handle);
    if add_result != 0 {
        let err_msg = LLVMOrcGetErrorMsg(add_result);
        eprintln!("添加IR模块失败: {}", String::from_utf8_lossy(CStr::from_ptr(err_msg).to_bytes()));
        LLVMOrcDisposeErrorMessage(err_msg);
        // 这里要终止流程处理错误，不要继续执行
        return Err(/* 自定义错误类型 */);
    }
}

不同版本的ORC JIT添加模块的函数可能略有不同（比如老版本可能用LLVMOrcAddIRModule），要确保你用的是对应版本的正确函数。

3. 函数的链接类型是否允许被导出 #

如果你的函数在IR里被标记为internal或者private链接类型，ORC JIT是不会把它作为全局符号导出的，自然找不到。你可以检查并修改函数的链接类型：

unsafe {
    let run_func = LLVMGetNamedFunction(module, b"run\0".as_ptr());
    let linkage = LLVMGetLinkage(run_func);
    println!("当前函数链接类型: {}", linkage);
    // 我们需要的是LLVMExternalLinkage（值为0）或者其他可导出的类型
    if linkage != LLVMExternalLinkage {
        LLVMSetLinkage(run_func, LLVMExternalLinkage);
        println!("已将函数链接类型改为外部可见");
    }
}

只有外部可见的符号才会被JIT暴露出来供查找。

4. 确认ORC JIT的符号查找范围覆盖了你的模块 #

有些时候，ORC JIT的符号搜索层可能没有包含你添加模块的那个层。比如如果你手动创建了自定义编译层，要确保这个层被添加到JIT的符号搜索空间里。另外，部分ORC版本需要你显式导出符号，比如通过LLVMOrcDefineEagerlyCompiledIR来提前编译并导出符号，而不是仅仅添加模块。

先从前面三点开始排查，尤其是符号名和模块添加这两点，大部分时候都是这两个原因导致的问题。

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