{"record":{"id":"a6cea009aa5c890e","repo":"apache/flink","slug":"could-not-load-the-provided-entrypoint-class","errorCode":null,"errorMessage":"Could not load the provided entrypoint class.","messagePattern":"Could not load the provided entrypoint class\\.","errorType":"exception","errorClass":"FlinkException","httpStatus":null,"severity":"error","filePath":"flink-clients/src/main/java/org/apache/flink/client/program/DefaultPackagedProgramRetriever.java","lineNumber":231,"sourceCode":"    @Override\n    public PackagedProgram getPackagedProgram() throws FlinkException {\n        try {\n            final PackagedProgram.Builder packagedProgramBuilder =\n                    PackagedProgram.newBuilder()\n                            .setUserClassPaths(userClasspath)\n                            .setArguments(programArguments)\n                            .setConfiguration(configuration);\n\n            entryClassInformationProvider\n                    .getJobClassName()\n                    .ifPresent(packagedProgramBuilder::setEntryPointClassName);\n            entryClassInformationProvider\n                    .getJarFile()\n                    .ifPresent(packagedProgramBuilder::setJarFile);\n\n            return packagedProgramBuilder.build();\n        } catch (ProgramInvocationException e) {\n            throw new FlinkException(\"Could not load the provided entrypoint class.\", e);\n        }\n    }\n\n    private static List<URL> getClasspathsFromUserLibDir(\n            @Nullable File userLibDir, @Nullable File jarFile) throws IOException {\n        if (userLibDir == null) {\n            return Collections.emptyList();\n        }\n\n        try (Stream<Path> files = Files.walk(userLibDir.toPath(), FileVisitOption.FOLLOW_LINKS)) {\n            return getClasspathsFromArtifacts(files, jarFile);\n        }\n    }\n\n    private static List<URL> getClasspathsFromArtifacts(\n            @Nullable Collection<File> userArtifacts, @Nullable File jarFile) {\n        if (userArtifacts == null) {\n            return Collections.emptyList();","sourceCodeStart":213,"sourceCodeEnd":249,"githubUrl":"https://github.com/apache/flink/blob/2f3c205e9266cb30240eb7f4fdab15cad629a70f/flink-clients/src/main/java/org/apache/flink/client/program/DefaultPackagedProgramRetriever.java#L213-L249","documentation":"Thrown by DefaultPackagedProgramRetriever.getPackagedProgram when PackagedProgram.newBuilder() fails to resolve and load the entrypoint class it derived from the job class name, the classpath, or the supplied JAR. Typically the class name points to a class absent from the user/system classpath or the JAR is malformed. Check that the entrypoint class exists and is reachable on the configured classpath.","triggerScenarios":"Triggered at runtime when the operation fails because: Could not load the provided entrypoint class.","commonSituations":"Commonly caused by misconfiguration, missing dependencies or files, unsupported types or operations, or invalid user input leading to: Could not load the provided entrypoint class.","solutions":["Address the cause reported by the error message: Could not load the provided entrypoint class.","Verify the inputs, configuration values, and classpath/dependency setup related to this operation, then retry."],"exampleFix":"Correct the condition described (\"Could not load the provided entrypoint class.\") and rerun the job or command.","handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"2f3c205e9266cb30240eb7f4fdab15cad629a70f","analyzedAt":"2026-08-14T08:48:24.518Z","contentChangedAt":"2026-08-14T08:48:24.518Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}