{"record":{"id":"00bb0265f95769c0","repo":"pinpoint-apm/pinpoint","slug":"not-found","errorCode":null,"errorMessage":" not found","messagePattern":" not found","errorType":"exception","errorClass":"IllegalStateException","httpStatus":null,"severity":"critical","filePath":"agent-module/bootstraps/bootstrap/src/main/java/com/navercorp/pinpoint/bootstrap/agentdir/AgentDirBaseClassPathResolver.java","lineNumber":66,"sourceCode":"    private final JarDescription bootstrapJava9 = new JarDescription(\"pinpoint-bootstrap-java9\", false);\n    private final JarDescription bootstrapJava9internal = new JarDescription(\"pinpoint-bootstrap-java9-internal\", false);\n    private final JarDescription bootstrapJava15 = new JarDescription(\"pinpoint-bootstrap-java15\", false);\n    private final JarDescription bootstrapJava16 = new JarDescription(\"pinpoint-bootstrap-java16\", false);\n    private final List<JarDescription> bootJarDescriptions = Arrays.asList(commons, commonsConfig, bootstrapCore, annotations, bootstrapJava9, bootstrapJava9internal, bootstrapJava15, bootstrapJava16);\n\n    private final Path bootstrapJarPath;\n\n\n\n    public AgentDirBaseClassPathResolver(Path bootstrapJarPath) {\n        this.bootstrapJarPath = Objects.requireNonNull(bootstrapJarPath, \"classPath\");\n    }\n\n\n    @Override\n    public AgentDirectory resolve() {\n        if (!Files.isRegularFile(bootstrapJarPath)) {\n            throw new IllegalStateException(bootstrapJarPath + \" not found\");\n        }\n\n        // find bootstrap.jar\n        final Path bootstrapJarName = this.findBootstrapJar(this.bootstrapJarPath);\n        if (bootstrapJarName == null) {\n            throw new IllegalStateException(bootstrap.getSimplePattern() + \" not found.\");\n        }\n\n        final Path agentDirPath = getAgentDirPath(this.bootstrapJarPath);\n\n        final BootDir bootDir = resolveBootDir(agentDirPath);\n\n        final Path agentLibPath = getAgentLibPath(agentDirPath);\n        final List<Path> libs = resolveLib(agentLibPath);\n\n        Path agentPluginPath = getAgentPluginPath(agentDirPath);\n        final List<Path> plugins = resolvePlugins(agentPluginPath);\n","sourceCodeStart":48,"sourceCodeEnd":84,"githubUrl":"https://github.com/pinpoint-apm/pinpoint/blob/744c3d3075e595656abb1ae331ad2c0e4c9eb996/agent-module/bootstraps/bootstrap/src/main/java/com/navercorp/pinpoint/bootstrap/agentdir/AgentDirBaseClassPathResolver.java#L48-L84","documentation":"Pinpoint's AgentDirBaseClassPathResolver.resolve() requires the bootstrap jar path to point to an existing regular file. When Files.isRegularFile(bootstrapJarPath) is false (missing file, or a directory/symlink to nothing), it throws IllegalStateException '<path> not found'. It signals the agent was launched with a bad bootstrap jar location so class path resolution cannot proceed.","triggerScenarios":"Starting the Pinpoint agent with a -javaagent or bootClass path that does not exist, points to a directory, or was moved/renamed; the resolved bootstrapJarPath argument to the constructor references a non-regular file.","commonSituations":"Wrong PINPOINT_AGENT path in launch scripts or JVM args; agent directory partially copied (bootstrap.jar missing); typos like pinpoint-bootstrap.jar vs pinpoint-bootstrap-core.jar; file deleted after an upgrade while an old start script still points at it.","solutions":["Verify the path exists and is a regular file: ls -l <bootstrapJarPath>; correct the -javaagent / boot jar path in the start script","Reinstall or re-extract the Pinpoint agent distribution so pinpoint-bootstrap*.jar is present in the agent dir","Check for symlinks pointing to a moved/deleted location and fix the symlink or use the real path","Ensure the user running the JVM has execute/read permission on the agent directory"],"exampleFix":"// before\n-javaagent:/opt/pinpoint-agent/pinpoint-bootstrap.jar\n// after\n-javaagent:/opt/pinpoint-agent-2.5.0/pinpoint-bootstrap.jar   # path verified with ls -l","handlingStrategy":"validation","validationCode":"Path boot = Paths.get(\"/opt/pinpoint-agent/pinpoint-bootstrap.jar\");\nif (!Files.isRegularFile(boot)) {\n    throw new IllegalArgumentException(\"bootstrap jar missing or not a file: \" + boot);\n}","typeGuard":"boolean isValidBootstrapJar(Path p) {\n    return p != null && Files.isRegularFile(p);\n}","tryCatchPattern":"try {\n    AgentDirectory dir = resolver.resolve();\n} catch (IllegalStateException e) {\n    if (e.getMessage() != null && e.getMessage().endsWith(\" not found\")) {\n        // log bootstrapJarPath, fail fast with corrected path instructions\n    }\n    throw e;\n}","preventionTips":["Always launch with an absolute -javaagent path","Verify agent directory integrity after extraction (bootstrap jar present) before JVM start","Avoid renaming Pinpoint jars; keep release layout intact","Pin the agent version directory in start scripts instead of a mutable symlink target"],"tags":["java","file-not-found","agent-bootstrap","startup"],"backgroundTag":"file-not-found","analyzedSha":"744c3d3075e595656abb1ae331ad2c0e4c9eb996","analyzedAt":"2026-09-07T18:48:45.289Z","contentChangedAt":"2026-09-07T18:48:45.289Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}