CORB删除MarkLogic文档出现外部变量未定义及连接报错如何解决

第一阶段报错：$URI变量未定义 + XSL文件加载警告 #

错误原因 #

1. 配置PROCESS_MODULE时文件名书写错误：transform-docs.xqy.xqy多了一个.xqy后缀，CORB无法找到正确的处理模块，自然无法给外部变量$URI传值
2. CORB 2.5.0版本存在已知的jar包资源加载缺陷，会导致内置的jobStatsToJson.xsl文件读取失败，程序阻塞无法退出

修复方案 #

• 修正PROCESS_MODULE的文件名，去掉多余的后缀
• 升级CORB到最新稳定版（你已完成该操作，对应报错消失符合预期）

第二阶段报错：MarkLogic数据库连接失败 #

错误原因 #

该报错是CORB无法和8067端口的MarkLogic XDBC服务建立连接，常见诱因如下：

• 8067端口对应的不是XDBC服务，是HTTP/REST等其他类型的应用服务
• MarkLogic服务未启动，或者8067端口没有正常监听
• 配置的admin账户没有访问TCOMP数据库、8067-TCOMP-modules模块库的权限
• MODULES_DATABASE配置的名称错误，或者模块数据库没有正确挂载到8067对应的XDBC服务上

修复步骤 #

1. 先手动验证XDBC服务可用性：打开MarkLogic管理后台，确认8067端口对应的应用服务类型为「XDBC Server」，且服务处于运行状态
2. 用XCC客户端直接连接xcc://admin:admin@localhost:8067/TCOMP，确认可以正常连接并执行语句
3. 检查get-uris.xqy、transform-docs.xqy的本地文件路径是否正确，配置INSTALL=1的情况下CORB会自动把本地模块上传到模块数据库，确认路径没有拼写错误
4. 如果不需要用模块数据库存储模块，可以继续用ADHOC模式加载本地文件，避免模块上传权限问题：

properties.put(Options.PROCESS_MODULE, "src/test/resources/transform-docs.xqy|ADHOC");
properties.put(Options.URIS_MODULE, "src/test/resources/get-uris.xqy|ADHOC");

5. 临时降低线程数到2-4测试，避免初始连接数过高触发MarkLogic的连接限制

额外优化建议 #

你的PROCESS_MODULE里$URI声明为xs:string*是多余的，CORB每次调用处理模块只会传单个URI，修改为xs:string即可：

xquery version "1.0-ml";
declare variable $URI as xs:string external;
xdmp:document-delete($URI)

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