{"record":{"id":"706f9ae9e4322286","repo":"flowable/flowable-engine","slug":"resourcename-is-null-706f9a","errorCode":null,"errorMessage":"resourceName is null","messagePattern":"resourceName is null","errorType":"validation","errorClass":"FlowableIllegalArgumentException","httpStatus":null,"severity":"error","filePath":"modules/flowable-event-registry/src/main/java/org/flowable/eventregistry/impl/ChannelDefinitionQueryImpl.java","lineNumber":294,"sourceCode":"        return this;\n    }\n    \n    @Override\n    public ChannelDefinitionQueryImpl channelCreateTimeAfter(Date createTimeAfter) {\n        this.createTimeAfter = createTimeAfter;\n        return this;\n    }\n    \n    @Override\n    public ChannelDefinitionQueryImpl channelCreateTimeBefore(Date createTimeBefore) {\n        this.createTimeBefore = createTimeBefore;\n        return this;\n    }\n\n    @Override\n    public ChannelDefinitionQueryImpl channelDefinitionResourceName(String resourceName) {\n        if (resourceName == null) {\n            throw new FlowableIllegalArgumentException(\"resourceName is null\");\n        }\n        this.resourceName = resourceName;\n        return this;\n    }\n\n    @Override\n    public ChannelDefinitionQueryImpl channelDefinitionResourceNameLike(String resourceNameLike) {\n        if (resourceNameLike == null) {\n            throw new FlowableIllegalArgumentException(\"resourceNameLike is null\");\n        }\n        this.resourceNameLike = resourceNameLike;\n        return this;\n    }\n\n    @Override\n    public ChannelDefinitionQueryImpl tenantId(String tenantId) {\n        if (tenantId == null) {\n            throw new FlowableIllegalArgumentException(\"form tenantId is null\");","sourceCodeStart":276,"sourceCodeEnd":312,"githubUrl":"https://github.com/flowable/flowable-engine/blob/d6d39ce1c69ff244f2d9dc6af756a9b95e865586/modules/flowable-event-registry/src/main/java/org/flowable/eventregistry/impl/ChannelDefinitionQueryImpl.java#L276-L312","documentation":"ChannelDefinitionQueryImpl.channelDefinitionResourceName() validates its argument and throws FlowableIllegalArgumentException when the resourceName is null. This is an eager fail-fast guard: a null resource name would produce a broken SQL LIKE/equals filter later, so the query API rejects it at the point of use instead. The error indicates the caller passed null where a non-null deployment resource name string is required.","triggerScenarios":"Calling channelDefinitionResourceName(null) on a ChannelDefinitionQuery, typically when the resource name value comes from an unpopulated variable, config property, or request parameter.","commonSituations":"Building repository queries dynamically where the resource name is optional upstream but passed through unconditionally; properties/env lookups returning null; deserialized DTOs with a missing field.","solutions":["Pass a non-null resource name, e.g. repositoryService.createChannelDefinitionQuery().channelDefinitionResourceName(\"my.channel\")","Check the value for null before building the query and skip calling channelDefinitionResourceName if absent","Use channelDefinitionResourceNameLike with a safe pattern if you need partial matching, guarding null the same way"],"exampleFix":"// before\nChannelDefinitionQuery q = repositoryService.createChannelDefinitionQuery().channelDefinitionResourceName(resourceName);\n// after\nChannelDefinitionQuery q = repositoryService.createChannelDefinitionQuery();\nif (resourceName != null) { q = q.channelDefinitionResourceName(resourceName); }","handlingStrategy":"validation","validationCode":"Objects.requireNonNull(resourceName, \"resourceName must not be null\");","typeGuard":"null","tryCatchPattern":"null","preventionTips":["Use Objects.requireNonNull at call sites to fail with a clearer message"],"tags":["null","query","fail-fast","event-registry"],"backgroundTag":"null-argument","analyzedSha":"d6d39ce1c69ff244f2d9dc6af756a9b95e865586","analyzedAt":"2026-09-11T06:41:19.413Z","contentChangedAt":"2026-09-11T06:41:19.413Z","schemaVersion":2},"datasetVersion":"2026-09-18T11:17:12.947Z"}