InitialFirst draft, may evolve based on feedback

Build Errors

Common build failures and their solutions

Symptoms

Build fails with Maven errors during qctl build or mvn compile.

Error: Could not resolve dependencies

Solution:

Check your pom.xml for correct qqq version

Run mvn dependency:resolve to diagnose

Ensure you have access to the qqq Maven repository

Error: Unsupported class file major version

Solution:

Verify Java 17+ is installed: java -version

Check JAVA_HOME points to correct JDK

Update your pom.xml to specify Java 17

Error: cannot find symbol for generated classes

Solution:

Clean and rebuild: qctl build --clean

Check annotation processor is configured in pom.xml

Verify IDE annotation processing is enabled

Use consistent Java version across team

Pin qqq version in pom.xml

Run qctl doctor to check environment

Help us improve this article. Feedback is used to prioritize content updates.