启动Nginx时出现Unknown directive "lua_package_path"错误求助

嘿，这个问题我之前折腾过，挺有代表性的！先给你拆解清楚：

为什么会出现这个错误？ #

lua_package_path根本不是原生Nginx支持的指令——它是OpenResty的ngx_lua模块提供的配置项。如果你的Nginx是普通原生版本（没编译ngx_lua，也没装OpenResty），启动时肯定会报这个错。

先确认：你是不是用的普通Nginx？如果是，得换成OpenResty（推荐，因为它预打包了所有Lua相关模块），或者手动给原生Nginx编译ngx_lua模块。

lua_package_path到底指向什么？ #

简单说，它是告诉Nginx的Lua模块**去哪里找第三方Lua库文件（.lua）**的搜索路径。格式是用分号分隔的路径模板，其中：

• ?.lua是占位符，会自动替换成你要加载的Lua库文件名（比如加载resty/openidc.lua时，?就对应resty/openidc）
• ;;表示保留默认的搜索路径（比如OpenResty内置的Lua库路径），别丢了，不然内置库会找不到

针对你安装的lua-resty-openidc和lua-resty-hmac怎么配置？ #

首先得找到这两个库的实际安装位置，常见的路径有两种情况：

情况1：用OpenResty自带的包管理安装（或默认路径） #

如果是通过OpenResty的opm工具安装的，或者你直接用了OpenResty默认安装，这两个库大概率在/usr/local/openresty/lualib/resty/目录下。

这时在你的nginx.conf的http块里添加以下配置：

http {
    # 配置Lua库的搜索路径
    lua_package_path "/usr/local/openresty/lualib/?.lua;;";
    # 顺便把C扩展库的路径也配上（有些Lua库依赖.so文件）
    lua_package_cpath "/usr/local/openresty/lualib/?.so;;";

    # 你的其他Nginx配置...
}

情况2：用luarocks安装的 #

如果是通过LuaRocks包管理器安装的，库文件可能在/usr/local/share/lua/5.1/（或对应Lua版本的目录）下。这时路径要包含LuaRocks的目录：

lua_package_path "/usr/local/share/lua/5.1/?.lua;/usr/local/openresty/lualib/?.lua;;";
lua_package_cpath "/usr/local/lib/lua/5.1/?.so;/usr/local/openresty/lualib/?.so;;";

最后验证配置 #

配置完后，先检查语法是否正确：

# 如果是OpenResty
openresty -t
# 如果是编译了ngx_lua的原生Nginx
nginx -t

如果提示test is successful，再重启Nginx/OpenResty就搞定了！

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