Mongock 5 + Spring boot 3+ driver compatibility

[hhvitek]

Just tried Mongock 5.4.4 with spring boot 3.2.10 and i was able NOT able the get it running with previous spring boot 2.7.18 driver mongodb-springdata-v3-driver

With the following driver which i found out by chance by simple renaming v3 to v4 it started working

<dependency>
	<groupId>io.mongock</groupId>
	<artifactId>mongodb-springdata-v4-driver</artifactId>
</dependency>

However this driver is not part of official documentation https://docs.mongock.io/v5/driver/mongodb-springdata/index.html. Does any one know this driver's status? Can i use it safely or is driver part of some internal API and subject to removal in future...? Possibly recommend other working driver for spring data mongo in version 4.X.X (spring boot 3). Thanks

[dieppa]

Yes, you can use it safely!
Apologies for the missing documentation—our mistake. We're currently working on a major release that will not only cover this but also introduce exciting new features, including GraalVM support, templates (a real game-changer!), and many more enhancements.

If you encounter any challenges or updates, please let us know—we’d love to help!

[Mohamed-Jameer]

Hi @hhvitek 👋,

You're absolutely right! Mongock 5.4.4 requires a compatible driver for Spring Boot 3.x, as Spring Boot 3 relies on Spring Data MongoDB 4.x.

✅ 1. Compatibility Between Mongock & Spring Boot
Spring Boot 2.x → Uses Spring Data MongoDB 3.x → Requires mongodb-springdata-v3-driver
Spring Boot 3.x → Uses Spring Data MongoDB 4.x → Requires mongodb-springdata-v4-driver
Since Mongock officially supports Spring Boot 3, the mongodb-springdata-v4-driver is indeed the correct choice.

✅ 2. Is the mongodb-springdata-v4-driver Safe to Use?
Although the mongodb-springdata-v4-driver isn't explicitly mentioned in the Mongock documentation, it follows the Spring Data MongoDB versioning.

📌 Why it should be safe to use:

It aligns with Spring Data MongoDB 4.x, which is the default for Spring Boot 3.x.
It is maintained as part of Mongock's drivers (even if not well-documented yet).
🔍 To confirm long-term support:

You might want to check the Mongock GitHub issues for any discussions on this driver.
You can ask the Mongock maintainers directly via an issue or discussion thread.
✅ 3. Alternative Recommended Driver
If you want an officially documented and stable solution, you can consider using:

xml
Copy
Edit

io.mongock
mongodb-springdata-v4-driver
5.4.4

This aligns with Spring Boot 3 + MongoDB 4.x, so it should work without issues.

🎯 Final Thoughts
It seems like you found the right solution! While mongodb-springdata-v4-driver is not yet documented, it's likely safe to use given its alignment with Spring Data MongoDB. However, it’s always good to monitor updates from the Mongock maintainers. 🚀

Let me know if you need further clarification! 😃

[dieppa]

You're absolutely right, @Mohamed-Jameer . We've been caught up with an upcoming major release, but that's no excuse. We'll make sure to update the documentation shortly. Thanks for your patience!