{"record":{"id":"16d8265d3ba13944","repo":"GoogleContainerTools/jib","slug":"message-from-buildstepsexecutionexception-16d826","errorCode":null,"errorMessage":"<message from BuildStepsExecutionException>","messagePattern":"<message from BuildStepsExecutionException>","errorType":"exception","errorClass":"MojoExecutionException","httpStatus":null,"severity":"error","filePath":"jib-maven-plugin/src/main/java/com/google/cloud/tools/jib/maven/BuildTarMojo.java","lineNumber":159,"sourceCode":"\n    } catch (IncompatibleBaseImageJavaVersionException ex) {\n      throw new MojoExecutionException(\n          HelpfulSuggestions.forIncompatibleBaseImageJavaVersionForMaven(\n              ex.getBaseImageMajorJavaVersion(), ex.getProjectMajorJavaVersion()),\n          ex);\n\n    } catch (InvalidImageReferenceException ex) {\n      throw new MojoExecutionException(\n          HelpfulSuggestions.forInvalidImageReference(ex.getInvalidReference()), ex);\n\n    } catch (IOException\n        | CacheDirectoryCreationException\n        | MainClassInferenceException\n        | InvalidGlobalConfigException ex) {\n      throw new MojoExecutionException(ex.getMessage(), ex);\n\n    } catch (BuildStepsExecutionException ex) {\n      throw new MojoExecutionException(ex.getMessage(), ex.getCause());\n\n    } catch (ExtraDirectoryNotFoundException ex) {\n      throw new MojoExecutionException(\n          \"<extraDirectories><paths> contain \\\"from\\\" directory that doesn't exist locally: \"\n              + ex.getPath(),\n          ex);\n    } finally {\n      tempDirectoryProvider.close();\n      MojoCommon.finishUpdateChecker(projectProperties, updateCheckFuture);\n      projectProperties.waitForLoggingThread();\n      getLog().info(\"\");\n    }\n  }\n}\n","sourceCodeStart":141,"sourceCodeEnd":174,"githubUrl":"https://github.com/GoogleContainerTools/jib/blob/fb949e2676afbbd7dd7a1ef61e20251931325654/jib-maven-plugin/src/main/java/com/google/cloud/tools/jib/maven/BuildTarMojo.java#L141-L174","documentation":"Thrown as a MojoExecutionException from BuildTarMojo.execute when the build steps themselves fail (BuildStepsExecutionException). Jib re-throws with the original message and the underlying cause, so this signals a generic failure during the actual containerization steps rather than a configuration validation problem.","triggerScenarios":"Any failure inside the Jib build pipeline — e.g. registry authentication/download errors, layer building/pushing failures, network issues — surfaced through the jib:buildTar goal.","commonSituations":"Unreachable or unauthenticated registries, Docker daemon issues for docker-build goals, transient network failures during base image pull, or errors producing/reading the tar output.","solutions":["Inspect the 'Caused by' chain in the Maven output for the true underlying failure (auth, network, registry error).","Run with -X or -e for the full stack trace, and check the registry is reachable and credentials are valid (credHelper or docker login).","Retry on transient network/registry failures; clear the Jib cache directory if it may hold corrupt state.","Confirm the base image exists and is accessible (private base images need authentication too)."],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":"// Retry transient causes once or twice with backoff; fail fast on auth/config causes.\n// Registry auth pre-check before build:\ndocker pull <base-image> || echo \"registry/auth problem before jib build\"","preventionTips":["Authenticate to registries beforehand (docker login or <credHelper> configuration).","Verify base and target registries are reachable from CI.","Inspect the 'Caused by' chain before assuming it's a Jib bug.","Keep the Jib cache clean when switching networks or registries."],"tags":["maven","jib","build-failure","registry"],"backgroundTag":"http-request-failed","analyzedSha":"fb949e2676afbbd7dd7a1ef61e20251931325654","analyzedAt":"2026-09-06T14:04:09.491Z","contentChangedAt":"2026-09-06T14:04:09.491Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}