为何设置LD_PRELOAD加载同路径libuci.so可避免obuspa进程崩溃？

AI 小北

2026-7-2

问题

我的应用obuspa在调用libuci.so链接库的标准OpenWRT库函数uci_lookup_ptr时崩溃。通过/lib/ld-linux.so.3 --list /sbin/obuspa查看，该库已在链接列表中：

# /lib/ld-linux.so.3 --list /sbin/obuspa
        libmosquitto.so.1 => /usr/lib/libmosquitto.so.1 (0xb68de000)
        libubus.so => /usr/lib/libubus.so (0xb68cf000)
        libubox.so => /usr/lib/libubox.so (0xb68bb000)
        libblobmsg_json.so => /usr/lib/libblobmsg_json.so (0xb68b0000)
        libuci.so => /lib/libuci.so (0xb689e000)
        libc.so.6 => /lib/libc.so.6 (0xb6766000)
        /lib/ld-linux.so.3 (0xb6f2d000)

但在shell环境中执行export LD_PRELOAD=/lib/libuci.so并重启应用后，进程运行正常，不再触发SIGSEGV信号（无段错误）。相关代码如下：

static int get_value_from_uci(char *path, char *value, size_t max_value_len)
{
    struct uci_context *uci_ctx;
    struct uci_ptr ptr;
    int ret = 0;

    if (!path || !value || max_value_len == 0)
            return -1;

    uci_ctx = uci_alloc_context();
    if (!uci_ctx)
            return -1;

    printf("%s, uci ctx : %p created, lookup for %s\n", __FUNCTION__, uci_ctx, path);
    if (uci_lookup_ptr(uci_ctx, &ptr, path, true) != UCI_OK) {
            ret = -1;
            uci_free_context(uci_ctx);
            printf("%s, uci lookup failed\n", __FUNCTION__);
            return ret;
    }
    printf("%s, uci ptr flag:%d\n", __FUNCTION__, ptr.flags);
    if ((ptr.flags & UCI_LOOKUP_COMPLETE)
            && (ptr.o != NULL)
            && (ptr.o->v.string!=NULL)) {
            ret = 0;
            USP_STRNCPY(value, ptr.o->v.string, max_value_len);
            printf("%s, uci lookup completed, value:%s\n", __FUNCTION__, value);
    }
    return ret;
}

int main()
{
    char cached_json_file[256] = {0};
    char uci_role_path[] = "obuspa.global.dm_caching_exclude";
    
    // Read rest of the roles from JSON, if defined
    printf("%s, GET UCI Role\n", __FUNCTION__);
    if (get_value_from_uci(uci_role_path, cached_json_file, 256) != 0)
            goto exit;
    ....
    return 0;
}

请问为何设置相同的共享库路径能避免进程崩溃？

分析与解答

共享库加载优先级强制覆盖：LD_PRELOAD会让动态链接器优先加载指定的/lib/libuci.so，跳过默认的加载顺序逻辑。即使链接列表显示该库已被引用，实际运行时可能存在其他隐式加载的同名/符号冲突库（比如依赖链中其他库间接引入的），导致符号解析混乱。预加载强制锁定了正确的库版本。
符号绑定顺序修正：默认动态链接采用延迟绑定（RTLD_LAZY），符号可能被其他库的同名符号覆盖，或者绑定到不兼容的实现上。LD_PRELOAD加载的库会优先完成符号绑定，确保uci_lookup_ptr等函数被解析到正确的/lib/libuci.so实现，避免因符号混淆导致的内存访问错误。
多版本库的ABI兼容问题：系统中可能存在多个版本的libuci.so，即使文件名相同，内部结构体定义（比如uci_context、uci_ptr）或函数实现的ABI存在差异。默认加载的版本与应用编译时依赖的版本不匹配，调用uci_lookup_ptr时会出现内存越界。LD_PRELOAD强制加载了编译时对应的兼容版本，解决了ABI不兼容问题。
依赖链中的版本冲突：应用依赖的其他库（如libubus.so、libubox.so）可能也依赖libuci.so，但它们加载的是另一个版本。动态链接器的依赖解析会导致应用混合使用不同版本库的符号，造成上下文混乱（比如结构体大小不一致导致的内存读写错误）。预加载统一了libuci.so的版本，消除了混合调用的风险。

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