Add opt-in MongoDB multi-document transactions to GORM for MongoDB

[codeconsole]

What

Adds opt-in MongoDB multi-document transactions to GORM for MongoDB.

Previously GORM for MongoDB never used a com.mongodb.client.ClientSession: every driver write was issued session-less and auto-committed, so a GORM transaction was only a client-side flush boundary — writes already flushed within it were not rolled back on failure (no server-side atomicity).

With grails.mongodb.transactional = true, a GORM transaction now starts and drives a real ClientSession transaction, so all reads and writes commit or roll back atomically:

Person.withTransaction {
    new Person(name: "Fred").save()
    new Person(name: "Wilma").save()
    // both commit together, or neither if an exception is thrown
}

How

• New MongoTransaction (replaces the flush-only SessionOnlyTransaction when enabled): commit() flushes then commitTransaction() (with bounded retry on UnknownTransactionCommitResult), rollback() aborts; both close the session. On commit failure the GORM session cache is cleared.
• AbstractMongoSession holds the active ClientSession, starts it in beginTransactionInternal(), and routes every read/write through small helpers that pass the session when a transaction is active and stay session-less otherwise.
• The session is threaded through both session engines, both persisters, MongoQuery, and the MongoStaticApi/MongoEntity surface.
• Core DatastoreTransactionManager is unchanged — it already orchestrates flush/commit/rollback; this just supplies a Transaction that drives a server transaction.

Opt-in and fallback

• Default is off (grails.mongodb.transactional defaults to false) — no behavior change for existing apps.
• Requires a replica set or sharded cluster. If a standalone topology is detected, the feature is disabled with a one-time warning and GORM falls back to the legacy flush behavior.

Boundaries

• Identifier generation (the native Long counter) is intentionally left non-transactional, mirroring database sequence semantics.
• Like GORM's transaction manager generally, a single flat transaction (PROPAGATION_REQUIRED) is supported; REQUIRES_NEW/NESTED are not.

Tests

• MongoTransactionSpec — commit persists multiple docs; rollback discards them on the server; read-your-writes within a transaction; cross-collection atomic rollback; findOneAndDelete participates in the transaction; nested GORM REQUIRES_NEW.
• MongoTransactionDisabledSpec — default-off keeps the legacy flush behavior.

Targets 8.0.x. Independent of #15743; this is also the prerequisite for a follow-up Spring Data MongoDB interop module.

[borinquenkid]

Hi @codeconsole,

Please keep an eye on #15678 (GORM: Shared Mapping Registry O(M+N) Scaling), which introduces significant internal structural refactoring to how GormRegistry and MongoDatastore handle tenant routing and fallback resolution.

Since that optimization is targeting 8.0.x-hibernate7, your transaction changes here will be downstream from those modifications. It might be worth checking your diff against those updates to prevent initialization order regressions or multi-tenant signature mismatches when merging into the 8.0 release line.

[testlens-app]

🚨 TestLens detected 8 failed tests 🚨

Here is what you can do:

1. Inspect the test failures carefully.
2. If you are convinced that some of the tests are flaky, you can mute them below.
3. Finally, trigger a rerun by checking the rerun checkbox.

Test Summary

CI - Groovy Joint Validation Build / build_grails > :grails-data-mongodb-core:test

Test	Runs
MongoTransactionSpec > test a REQUIRES_NEW inner transaction commits independently of a rolled back outer transaction	❌
MongoTransactionSpec > test a committed transaction persists all writes atomically	❌
MongoTransactionSpec > test a findOneAndDelete via the MongoEntity API participates in the transaction	❌
MongoTransactionSpec > test a rolled back transaction discards a native Long id entity (id generation is non-transactional)	❌
MongoTransactionSpec > test a rolled back transaction discards all writes on the server	❌
MongoTransactionSpec > test native Long identifier generation works for entities committed in a transaction	❌
MongoTransactionSpec > test read-your-writes within an active transaction	❌
MongoTransactionSpec > test writes across multiple collections roll back together	❌

🏷️ Commit: 9993091
▶️ Tests: 32651 executed
🟡 Checks: 43/44 completed

Muted Tests

Note

Checks are currently running using the configuration below.

Select tests to mute in this pull request:

🔲 MongoTransactionSpec > test a REQUIRES_NEW inner transaction commits independently of a rolled back outer transaction
🔲 MongoTransactionSpec > test a committed transaction persists all writes atomically
🔲 MongoTransactionSpec > test a findOneAndDelete via the MongoEntity API participates in the transaction
🔲 MongoTransactionSpec > test a rolled back transaction discards a native Long id entity (id generation is non-transactional)
🔲 MongoTransactionSpec > test a rolled back transaction discards all writes on the server
🔲 MongoTransactionSpec > test native Long identifier generation works for entities committed in a transaction
🔲 MongoTransactionSpec > test read-your-writes within an active transaction
🔲 MongoTransactionSpec > test writes across multiple collections roll back together

Reuse successful test results:

🔲 ♻️ Only rerun the tests that failed or were muted before

Click the checkbox to trigger a rerun:

☑️ Rerun jobs

---

Learn more about TestLens at testlens.app.