{"record":{"id":"cb42313e218f44b3","repo":"apache/rocketmq","slug":"consumer-data-is-null","errorCode":null,"errorMessage":"consumer data is null.","messagePattern":"consumer data is null\\.","errorType":"exception","errorClass":"AuthorizationException","httpStatus":null,"severity":"error","filePath":"auth/src/main/java/org/apache/rocketmq/auth/authorization/builder/DefaultAuthorizationContextBuilder.java","lineNumber":345,"sourceCode":"                        throw new AuthorizationException(\"subscription is null.\");\n                    }\n                    result.add(DefaultAuthorizationContext.of(subject,\n                        Resource.ofTopic(requireResource(\n                            checkClientBody.getSubscriptionData().getTopic(), \"topic\")),\n                        Action.SUB, sourceIp));\n                    result.add(DefaultAuthorizationContext.of(subject,\n                        Resource.ofGroup(requireResource(checkClientBody.getGroup(), \"consumer group\")),\n                        Action.SUB, sourceIp));\n                    break;\n                case RequestCode.QUERY_MESSAGE:\n                    topic = Resource.ofTopic(requireResource(fields.get(TOPIC), \"topic\"));\n                    result.add(DefaultAuthorizationContext.of(subject, topic, Arrays.asList(Action.SUB, Action.GET), sourceIp));\n                    break;\n                case RequestCode.HEART_BEAT:\n                    HeartbeatData heartbeatData = decodeRequiredBody(command, HeartbeatData.class, \"heartbeat\");\n                    for (ConsumerData data : heartbeatData.getConsumerDataSet()) {\n                        if (data == null) {\n                            throw new AuthorizationException(\"consumer data is null.\");\n                        }\n                        group = Resource.ofGroup(requireResource(data.getGroupName(), \"consumer group\"));\n                        result.add(DefaultAuthorizationContext.of(subject, group, Action.SUB, sourceIp));\n                        for (SubscriptionData subscriptionData : data.getSubscriptionDataSet()) {\n                            if (subscriptionData == null) {\n                                throw new AuthorizationException(\"subscription is null.\");\n                            }\n                            String subscriptionTopic =\n                                requireResource(subscriptionData.getTopic(), \"topic\");\n                            if (NamespaceUtil.isRetryTopic(subscriptionTopic)) {\n                                continue;\n                            }\n                            topic = Resource.ofTopic(subscriptionTopic);\n                            result.add(DefaultAuthorizationContext.of(subject, topic, Action.SUB, sourceIp));\n                        }\n                    }\n                    break;\n                case RequestCode.UNREGISTER_CLIENT:","sourceCodeStart":327,"sourceCodeEnd":363,"githubUrl":"https://github.com/apache/rocketmq/blob/293f5885719fc4aa3619446a1900f58ccfcfdd29/auth/src/main/java/org/apache/rocketmq/auth/authorization/builder/DefaultAuthorizationContextBuilder.java#L327-L363","documentation":"Error \"consumer data is null.\" thrown in apache/rocketmq.","triggerScenarios":"Occurs when building an authorization context for a request whose consumer data is null.","commonSituations":"A consumer registration or heartbeat request arrives without consumer data, or the body failed to decode.","solutions":["Ensure the consumer data (group, subscriptions) is populated in the heartbeat/registration request.","Verify the consumer client has registered at least one subscription before sending consumer data.","Check client-broker version compatibility for the consumer data payload."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"293f5885719fc4aa3619446a1900f58ccfcfdd29","analyzedAt":"2026-08-14T11:50:13.822Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}