Nginx集成Keycloak时lua-resty-session模块加载错误求助

从你贴的错误堆栈来看，核心问题是在调用resty.session.new()时，系统尝试加载AES加密模块resty.session.ciphers.aes失败，提示"loop or previous error loading module"。这种情况一般是模块路径配置问题、依赖缺失或者包安装不完整导致的，下面给你一步步排查的思路：

1. 先确认模块文件是否存在 #

首先手动检查lua-resty-session的安装目录里有没有这个AES模块文件：

ls -l /usr/local/share/lua/5.1/resty/session/ciphers/

如果输出里没有aes.lua，说明你的lua-resty-session包安装不完整，需要重新安装。用luarocks或者opm重新安装都可以：

# 用luarocks的话
luarocks install lua-resty-session --force

# 用OpenResty的opm工具
opm get openresty/lua-resty-session

2. 检查Nginx的Lua模块路径配置 #

Nginx需要知道去哪里找Lua模块，你得确保主配置（比如nginx.conf）里的lua_package_path和lua_package_cpath包含了lua-resty-session的安装路径。添加类似这样的配置：

http {
    # ...其他配置
    lua_package_path "/usr/local/share/lua/5.1/?.lua;/usr/local/share/lua/5.1/?/init.lua;;";
    lua_package_cpath "/usr/local/lib/lua/5.1/?.so;;";
}

配置完后重启Nginx，让路径生效。

3. 检查依赖库是否齐全 #

resty.session.ciphers.aes依赖resty.string（OpenResty自带的加密模块）和OpenSSL的Lua绑定。如果是单独安装的Lua环境，可能需要额外安装lua-resty-string：

luarocks install lua-resty-string

另外，建议使用较新的OpenResty稳定版（比如1.19.x以上），旧版本可能存在加密模块的兼容性问题。

4. 修复配置里的拼写错误 #

注意到你的Nginx配置中，discovery字段的URL写的是http://www.keyclock.com:8080/...——这里keyclock少了一个字母o，应该是keycloak。这个拼写错误虽然不是当前模块加载失败的直接原因，但后续认证肯定会失败，建议先修正。

5. 调试模块加载的具体错误 #

如果上面的步骤都没解决问题，可以在access_by_lua里加一段调试代码，打印更详细的错误信息：

access_by_lua '
    -- 打印当前Lua的包路径，方便排查
    ngx.log(ngx.INFO, "Lua package path: ", package.path)
    ngx.log(ngx.INFO, "Lua package cpath: ", package.cpath)
    
    -- 手动尝试加载AES模块，捕获具体错误
    local ok, err = pcall(require, "resty.session.ciphers.aes")
    if not ok then
        ngx.log(ngx.ERR, "Failed to load AES module: ", err)
    end
    
    -- 你的原有配置
    local opts = {
        redirect_uri_path = "/redirect_uri",
        accept_none_alg = true,
        discovery = "http://www.keycloak.com:8080/auth/realms/test/.well-known/openid-configuration",
        client_id = "nginx",
        client_secret = "84a5616b-9cee-4feeecc-836f-8856c958ef54",
        redirect_uri_scheme = "http",
        logout_path = "/logout",
        redirect_after_logout_uri = "http://www.keycloak.com:8080/auth/realms/test/protocol/openid-connect/logout?redirect_uri=http://www.keycloak.com/",
        redirect_after_logout_with_id_token_hint = false,
        session_contents = {id_token=true}
    }
    local res, err = require("resty.openidc").authenticate(opts)
    if err then
        ngx.status = 403
        ngx.say(err)
        ngx.exit(ngx.HTTP_FORBIDDEN)
    end
';

然后查看Nginx的错误日志（一般在/var/log/nginx/error.log），里面会显示加载模块时的具体错误信息，比如找不到某个依赖文件，或者版本不兼容。

6. 检查包版本兼容性 #

lua-resty-openidc和lua-resty-session有版本依赖关系，旧版本的组合可能会出现模块加载问题。建议把这两个包都更新到最新稳定版：

luarocks install lua-resty-openidc --force
luarocks install lua-resty-session --force

按照上面的步骤排查，应该能解决模块加载失败的问题。如果还有疑问，可以把调试输出的错误日志贴出来，进一步分析。

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