{"record":{"id":"b9755321d3466b58","repo":"pinpoint-apm/pinpoint","slug":"pinpoint-start-failed","errorCode":null,"errorMessage":"pinpoint start failed.","messagePattern":"pinpoint start failed\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"agent-module/bootstraps/bootstrap/src/main/java/com/navercorp/pinpoint/bootstrap/PinpointStarter.java","lineNumber":117,"sourceCode":"            AgentBootLoader agentBootLoader = new AgentBootLoader(agentType.getClassName(), agentClassLoader);\n            logger.info(String.format(\"pinpoint agent [%s] starting...\", agentType));\n\n            final List<Path> pluginJars = agentDirectory.getPlugins();\n            AgentOption option = createAgentOption(\n                    instrumentation,\n                    properties,\n                    agentArgs,\n                    agentDirectory.getAgentDirPath(),\n                    pluginJars,\n                    agentDirectory.getBootDir().getJarPath());\n            Object agent = agentBootLoader.boot(option);\n            Class<?> agentClazz = agent.getClass();\n            agentClazz.getMethod(\"start\").invoke(agent);\n            agentClazz.getMethod(\"registerStopHandler\").invoke(agent);\n            logger.info(\"pinpoint agent started normally.\");\n        } catch (Exception e) {\n            // unexpected exception that did not be checked above\n            logger.warn(\"pinpoint start failed.\", e);\n            return false;\n        }\n        return true;\n    }\n\n    // TestAgent only\n    public static final String IMPORT_PLUGIN = \"profiler.plugin.import-plugin\";\n\n\n    private Properties loadProperties() {\n\n        final Path agentDirPath = agentDirectory.getAgentDirPath();\n        final Path profilesPath = agentDirectory.getProfilesPath();\n        final List<Path> profileDirs = agentDirectory.getProfileDirs();\n\n        final Properties javaSystemProperty = copyJavaSystemProperty();\n        final Properties osEnvProperty = copyOSEnvVariables();\n","sourceCodeStart":99,"sourceCodeEnd":135,"githubUrl":"https://github.com/pinpoint-apm/pinpoint/blob/744c3d3075e595656abb1ae331ad2c0e4c9eb996/agent-module/bootstraps/bootstrap/src/main/java/com/navercorp/pinpoint/bootstrap/PinpointStarter.java#L99-L135","documentation":"The catch-all in PinpointStarter.start(): after properties are validated and the agent class loaded reflectively, any unexpected exception during reflective invocation of start()/registerStopHandler() is logged as this warning and agent startup returns false. It signals a bug or an unchecked environment problem, since checked failures are handled earlier.","triggerScenarios":"The loaded PinpointAgent class throws during initialization — e.g. failed network connection to collector, missing plugin dependencies, config values invalid only at runtime, or NoSuchMethod/IllegalAccessException from a classloader/version mismatch.","commonSituations":"Collector unreachable (profiler.config transport errors surfacing as unexpected exceptions); mismatched agent-module jar versions inside the agent dir; plugin jars incompatible with the agent version; JVM not officially supported.","solutions":["Inspect the full chained stack trace under this warning for the root cause","Verify collector host/port and network connectivity from the agent","Ensure all jars in the agent directory come from the same Pinpoint version","Check JVM support for your Pinpoint version and enable finer log levels for the starter"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":"// shell: pre-launch checks\nnc -z \"$COLLECTOR_HOST\" \"$COLLECTOR_PORT\" || echo \"collector unreachable\"\nls \"$AGENT_DIR\"/lib | awk -F- '{print $1}' | sort -u | grep -c . # spot mixed versions","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Always read the chained stack trace under this warning for the root cause","Keep all agent-dir jars at the same Pinpoint version","Verify collector connectivity from the agent host before startup","Use a JVM version supported by your Pinpoint release"],"tags":["java","javaagent","startup","reflection","pinpoint-agent"],"backgroundTag":"module-init-failed","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"}