Skip to main content

​
Installation and setup

Your project is building with an older Java version. Verify that Java 25 is active:
java -version
Also check the Java version Maven is using:
mvn -version
If either reports a version older than 25, update your PATH or JAVA_HOME to point to a Java 25 installation.
Another process is using port 8080. Either stop the other process, or configure the Agents server to use a different port:
DIFFBLUE_AGENTS_SERVER_PORT=8081 diffblue-agents run --workflow regression-unit-test-generation
The CLI cannot reach the Agents server. Verify the server is running:
curl http://localhost:8080/workflows
If the server is running on a non-default port, set the port in your environment:
export DIFFBLUE_AGENTS_SERVER_PORT=<your-port>

​
Licensing

Check the following:
  • Your machine has network access to the LicenseSpring service.
  • Your system clock is accurate. License validation is time-sensitive.
  • The license key is entered correctly, including hyphens.
If the issue persists, contact your Diffblue account manager.
Your license quota (measured in additional lines covered) has been reached. The current workflow completes its in-progress work but does not start new partitions.Check your remaining quota:
diffblue-agents license
Contact your Diffblue account manager to discuss increasing your quota.

​
Workflow execution

The workflow checks that your project builds and existing tests pass before generating new tests. If validation fails:
  1. Run mvn compile to verify the project builds.
  2. Run mvn test to verify existing tests pass.
  3. Fix any build or test failures, then re-run the workflow.
Agents validates every generated test by compiling and running it. Tests that fail validation are rolled back automatically. This is expected behaviour. The workflow summary shows how many tests were committed and how many were rolled back.A high rollback rate may indicate that the target code is difficult to test in isolation, or that the project has complex dependencies that affect test execution.
Agents generates tests in a temporary worktree and cherry-picks committed tests back to your branch. If you made changes to the same files while the workflow was running, cherry-pick conflicts can occur.Resolve conflicts using standard git conflict resolution. The workflow reports which commits had conflicts.