MarkLogic v11.1.0中xdmp:jwt-decode()函数未定义问题求助

xdmp:jwt-decode()是MarkLogic 11新增的函数，出现未定义错误通常和模块加载、权限或服务器配置有关，以下是具体排查和解决方法：

核心排查点 #

• 该函数属于Security扩展库，默认情况下需要确保App Server已启用Security模块支持，无需显式导入模块，但执行查询的用户需要对应权限。

具体步骤 #

1. 确认服务器配置
   登录MarkLogic管理控制台，检查目标App Server的设置：

   • 查看“Modules”选项下的模块路径是否包含Security相关路径（通常是/MarkLogic/security/）
   • 确认“Allowed Modules”配置未限制Security函数的访问

2. 检查执行权限
   在QConsole中切换到具有security或admin角色的用户执行查询，普通用户可能没有访问该函数的权限。

3. 验证函数是否存在
   执行以下查询确认函数是否已加载：

   xquery version "1.0-ml";
   xdmp:function(xs:QName("xdmp:jwt-decode"))
   

   返回函数元数据说明函数存在，问题出在权限或上下文；若仍报错，需检查MarkLogic安装/升级是否完整，必要时重新安装对应版本。

4. 手动解析JWT的替代方案
   如果暂时无法启用xdmp:jwt-decode()，可以手动解析JWT结构：

   xquery version "1.0-ml";
   let $jwt := "<JWT content here>"
   let $parts := fn:tokenize($jwt, "\.")
   let $header := xdmp:base64url-decode($parts[1])
   let $payload := xdmp:base64url-decode($parts[2])
   return
     <jwt>
       <header>{xdmp:from-json($header)}</header>
       <payload>{xdmp:from-json($payload)}</payload>
     </jwt>
   

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