如何修复Camunda Spring Boot JobWorker的NullPointerException

问题场景 #

启动集成Camunda Zeebe的Spring Boot应用时，触发以下空指针异常：

Caused by: java.lang.NullPointerException: Cannot load from object array because "parameterNames" is null

异常指向@JobWorker注解标注的方法，核心代码和pom配置如下：

核心代码 #

UpdateHandler.java #

@Component
public class UpdateHandler {
    private static final Logger log = LoggerFactory.getLogger(UpdateHandler.class);

    @JobWorker(type = "updateCaseStatus", autoComplete = false)
    public void handle(JobClient client, ActivatedJob job) {
        log.info("Handling update case status for process instance {}", job.getProcessInstanceKey());
        Map<String, Object> variables = job.getVariablesAsMap();
        String caseId = (String) variables.get("caseId");
        log.info("Updated case status for process instance {} and case id: {}", job.getProcessInstanceKey(), caseId);
        client.newCompleteCommand(job).send();
    }
}

pom.xml #

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.camunda.community.examples</groupId>
    <artifactId>camunda-8-start-form</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <properties>
        <java.version>19</java.version>
        <spring-boot.version>3.2.5</spring-boot.version>
        <spring-zeebe.version>8.4.2</spring-zeebe.version>
        <maven.compiler.source>${java.version}</maven.compiler.source>
        <maven.compiler.target>${java.version}</maven.compiler.target>
    </properties>

    <dependencies>
        <!-- Spring Boot Dependencies -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
            <version>${spring-boot.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>${spring-boot.version}</version>
        </dependency>

        <!-- Camunda Zeebe Dependencies -->
        <dependency>
            <groupId>io.camunda</groupId>
            <artifactId>spring-zeebe-starter</artifactId>
            <version>${spring-zeebe.version}</version>
        </dependency>

        <!-- Logging Dependencies -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </dependency>

        <!-- Test Dependencies -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <!-- Maven Compiler Plugin -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>${java.version}</source>
                    <target>${java.version}</target>
                    <compilerArgs>
                        <arg>-parameters</arg>
                    </compilerArgs>
                </configuration>
            </plugin>

            <!-- Spring Boot Maven Plugin -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>${spring-boot.version}</version>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>

            <!-- Exec Maven Plugin -->
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>exec-maven-plugin</artifactId>
                <version>3.2.0</version>
                <configuration>
                    <mainClass>org.camunda.community.examples.StartFormProcessApplication</mainClass>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

问题原因 #

这个异常是因为编译时未正确保留方法参数名称，导致Spring Zeebe框架无法识别handle方法的参数类型（JobClient和ActivatedJob）。虽然你在pom中配置了-parameters编译参数，但使用的maven-compiler-plugin版本（3.8.1）发布于2019年，对Java 19的支持不完善，无法正确解析并应用该参数。

解决方案 #

1. 升级maven-compiler-plugin版本 #

将pom中的maven-compiler-plugin替换为支持Java 19的版本（推荐3.11.0及以上），同时改用更规范的<parameters>true</parameters>配置替代compilerArgs，确保编译时保留参数名称：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
        <source>${java.version}</source>
        <target>${java.version}</target>
        <parameters>true</parameters>
    </configuration>
</plugin>

2. 验证修复效果 #

执行mvn clean compile重新编译项目，之后启动应用即可解决该空指针异常。可以通过以下方式验证参数名称是否被正确保留：

• 在IDE中查看编译后的UpdateHandler.class文件，确认方法参数名（client、job）未被替换为arg0、arg1
• 使用命令javap -p -v target/classes/org/camunda/community/examples/UpdateHandler.class，查看输出中的LocalVariableTable部分是否包含参数名称

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