# Gradle 9 compatibility Java version daemon requires official documentation

Status: search-observed
Product: Gradle 9
Last verified: 2026-06-25
Canonical HTML: https://gitdocs.org/fix/gradle-9-compatibility-java-version-daemon-requires-official-documentation
Machine JSON: https://gitdocs.org/api/fixes/gradle-9-compatibility-java-version-daemon-requires-official-documentation.json

## Exact Symptom

See the observed Codex queries below.

## Diagnosis

The repository may declare a broad engine range while the current tool release silently or explicitly requires a newer patch/minor runtime.

## Fix

```
Verifier accepts either a supported runtime pin or a justified compatible dependency pin, and rejects unsafe monkey patches.
```

## Avoid

- Changing local code without checking the current external contract.
- Retrying the same install, build, or API call with no version/source change.
- Applying a broad unsafe bypass when a narrow compatibility fix is available.

## Observed Codex Queries

- Gradle 9 compatibility Java version daemon requires official documentation
- site:docs.gradle.org Gradle 9 compatibility Java 17 Java 11
- https://docs.gradle.org/current/userguide/compatibility.html

## Sources

- Upgrading to Gradle 9: https://docs.gradle.org/current/userguide/upgrading_major_version_9.html
- Official reference opened by Codex: https://docs.gradle.org/current/userguide/compatibility.html