编写MarkLogic备份Gradle任务调用XQuery时ServerEvaluationCall抛空指针

问题根因 #

你遇到的空指针问题由两个常见的Gradle + MarkLogic Gradle插件使用错误导致：

1. 代码执行时机错误：你把业务逻辑直接写在任务声明的闭包中，这部分代码会在Gradle的配置阶段执行，此时hubConfig、host、port等配置参数还未完成加载初始化，取值为null，调用方法自然触发空指针。
2. 重复初始化客户端：ServerEvalTask本身已经内置了MarkLogic客户端的初始化逻辑，不需要你手动创建DatabaseClient实例，自行初始化反而容易因为配置未加载完成出问题。

解决方案 #

方案1：直接使用ServerEvalTask内置能力（推荐）

直接配置任务的内置属性即可，不需要自己写客户端调用逻辑：

task mlBackupTask(type: com.marklogic.gradle.task.ServerEvalTask) {
  // 配置阶段仅设置任务参数，不执行业务逻辑
  modulePath = "/admin/create-backup.xqy"
  variables = ["config-name": "dev"]
  // 指定使用staging环境的客户端执行请求
  client = hubConfig.newStagingClient()
}

运行任务后，返回结果会直接打印在控制台，你也可以添加doLast块自定义结果处理逻辑。

方案2：保留自定义调用逻辑的写法

如果你需要自己控制调用流程，必须把业务逻辑放到doLast块中，确保代码在Gradle的执行阶段（所有配置加载完成后）才运行：

task mlBackupTask(type: com.marklogic.gradle.task.ServerEvalTask) {
  doLast {
    // 执行阶段再初始化客户端，此时hubConfig已完成加载
    def client = hubConfig.newStagingClient()
    println "获取到的客户端实例：${client}"
    ServerEvaluationCall invoker = client.newServerEval()
    String result = invoker.modulePath("/admin/create-backup.xqy")
        .addVariable("config-name", "dev")
        .evalAs(String.class)
    println "备份任务执行结果：${result}"
  }
}

额外排查点 #

如果你坚持使用DatabaseClientFactory手动初始化客户端，需要确认以下两点：

• 所有参数host、portno、username、password的取值逻辑也放到doLast块中，确保执行阶段才能取到有效值
• 你已经在build.gradle中引入了marklogic-client-api的相关依赖，确保类可以正常加载

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