{"record":{"id":"2f08f82545d21d0f","repo":"apache/beam","slug":"javadoc-not-generated-check-logs-for-errors","errorCode":null,"errorMessage":"Javadoc not generated. Check logs for errors","messagePattern":"Javadoc not generated\\. Check logs for errors","errorType":"console","errorClass":"GradleException","httpStatus":null,"severity":"error","filePath":"sdks/java/javadoc/build.gradle","lineNumber":99,"sourceCode":"      links createJavadocIOUrlForDependency(dep)\n    }\n  }\n\n  // certain projects need generated sources for javadoc generation\n  // Part of flink sources came from custom copySourceOverrides target\n  dependsOn \":runners:flink:${flink_versions.split(\",\").first()}:copySourceOverrides\"\n  // Auto value class appeared in class annotation (jackson)\n  dependsOn ':sdks:java:io:solace:compileJava'\n  source project(':sdks:java:io:solace').layout.buildDirectory.dir('generated/sources/annotationProcessor/java/main')\n  dependsOn ':sdks:java:io:amazon-web-services2:compileJava'\n  source project(':sdks:java:io:amazon-web-services2').layout.buildDirectory.dir('generated/sources/annotationProcessor/java/main')\n\n  doLast {\n    File myFile = new File(layout.buildDirectory.dir(\"docs/javadoc/index.html\").get().toString())\n\n    // Because we set failOnError false, Check if the doc successfully generated\n    if (!myFile.exists()) {\n      throw new GradleException(\"Javadoc not generated. Check logs for errors\")\n    }\n  }\n}\n","sourceCodeStart":81,"sourceCodeEnd":103,"githubUrl":"https://github.com/apache/beam/blob/12126d8942aaf848030c478b4c6a28c6af861c66/sdks/java/javadoc/build.gradle#L81-L103","documentation":"Beam's javadoc Gradle task sets failOnError=false so warnings do not break the build, but afterwards it checks whether docs/javadoc/index.html was produced. If the Javadoc tool failed hard enough that no index.html exists, the build throws this GradleException.","triggerScenarios":"Running `./gradlew :sdks:java:javadoc:javadoc` when the javadoc tool exits with errors (bad doc comments, broken links, missing sources) so severe that no output index.html is generated.","commonSituations":"Adding a new class with malformed Javadoc tags or invalid {@link} references; JDK version change making previously tolerated doc errors fatal; missing dependencies on the javadoc classpath.","solutions":["Rerun the task and inspect the build logs above the failure for the actual javadoc errors.","Fix the reported Javadoc issues (broken @link/@param tags, missing comments, unresolvable references).","Run with --info or --debug to see the exact javadoc command output if the log is not clear."],"exampleFix":null,"handlingStrategy":"validation","validationCode":"./gradlew :sdks:java:javadoc:javadoc --info | grep -i 'error\\|warning'","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Run javadoc locally before CI and read the warnings.","Keep doc comments lint-clean (valid @link/@param tags) when adding new APIs."],"tags":["gradle","javadoc","build","documentation"],"backgroundTag":"file-not-found","analyzedSha":"12126d8942aaf848030c478b4c6a28c6af861c66","analyzedAt":"2026-09-13T01:50:10.254Z","contentChangedAt":"2026-09-13T01:50:10.254Z","schemaVersion":2},"datasetVersion":"2026-09-20T03:17:13.778Z"}