无法加载OPM安装的OpenResty lua-resty-radixtree库求助

API 探路者

2026-7-19

解决OpenResty无法加载librestyradixtree.so的问题

问题原因

OpenResty安装路径与OPM库安装路径不匹配：你的OpenResty二进制位于/usr/bin/openresty，但OPM默认将库安装到/usr/local/openresty目录下，导致运行时搜索路径无法找到.so文件。
nginx.conf中lua_package_cpath配置未正确指向.so文件的实际存放路径。

解决步骤

1. 定位librestyradixtree.so的实际位置

执行以下命令查找文件路径：

find / -name librestyradixtree.so 2>/dev/null

OPM安装的文件通常位于/usr/local/openresty/lib64/lua/5.1/或/usr/local/openresty/lualib/resty/目录下。

2. 修正nginx.conf中的路径配置

在http块中添加或更新lua_package_cpath和lua_package_path，指向库文件所在目录（以找到的实际路径为准）：

http {
    # 保留原有配置，新增或修改以下两行
    lua_package_cpath "/usr/local/openresty/lib64/lua/5.1/?.so;;";
    lua_package_path "/usr/local/openresty/lualib/?.lua;;";

    # 其他配置...
}

注意末尾的;;表示保留OpenResty默认的搜索路径，避免完全覆盖导致其他库无法加载。

3. 验证并重启OpenResty

检查配置是否正确：

/usr/bin/openresty -t

如果配置无错误，重启服务：

/usr/bin/openresty -s reload

4. 备选方案：调整环境变量或复制库文件

设置环境变量：启动OpenResty前指定LUA_CPATH，确保包含库路径：
```
export LUA_CPATH="/usr/local/openresty/lib64/lua/5.1/?.so;;"
/usr/bin/openresty -s reload
```
若需永久生效，可将该环境变量添加到OpenResty的启动脚本（如systemd服务文件或/etc/init.d/openresty）中。
复制库文件：先查看OpenResty默认的Lua搜索路径：
```
/usr/bin/openresty -V 2>&1 | grep lua_package_cpath
```
将librestyradixtree.so复制到输出路径对应的目录下，无需修改配置即可加载。