How do Django atomic blocks, savepoints, and on_commit callbacks work together?

Defines Django transaction nesting, exception boundaries, and post-commit work without promising durability.

1Say itAnswer out loud first

2CompareCompare with Core answer

3RefineRefine with Stronger and Advanced

TL;DR

The outermost transaction.atomic() block opens a transaction, and nested atomic blocks normally create savepoints. Leaving a block successfully commits its transaction or releases its savepoint; an exception rolls back to the matching boundary. I catch expected database exceptions outside the atomic block that should roll back, not inside a broken transaction. This keeps Django aware of whether later queries are valid.

Full answer below

Practice focus

Defines Django transaction nesting, exception boundaries, and post-commit work without promising durability.

Answer first

Answer path

Core answer first, then checkpoints toward a stronger answer.

Start
Core answer
Start here. This is the direct spoken answer to practice first.
Overview
Defines Django transaction nesting, exception boundaries, and post-commit work without promising durability.
The outermost transaction.atomic() block opens a transaction, and nested atomic blocks normally create savepoints. Leaving a block successfully commits its transaction or releases its savepoint; an exception rolls back to the matching boundary. I catch expected database exceptions outside the atomic block that should roll back, not inside a broken transaction. This keeps Django aware of whether later queries are valid.
Checkpoint
Stronger answer
Optional upgrade with examples, trade-offs, and sharper phrasing.
transaction.on_commit() registers work to run only after the outer transaction commits successfully. A callback registered inside a savepoint is discarded if that savepoint rolls back. It is useful for cache invalidation or starting noncritical follow-up work after data is visible, but the callback is not part of the database transaction and its failure cannot roll back the commit. Django tests also need deliberate handling because normally never commits.

Review signals

Use these to catch weak phrasing, shallow reasoning, and risky claims.

Common mistakesCandidateCommon mistakesMistakes that weaken the answer or signal shallow understanding.Open details

Details

Catching integrity errors inside the same atomic block
Treating on_commit as durable messaging
Wrapping slow external calls in a transaction

How do Django atomic blocks, savepoints, and on_commit callbacks work together?

Practice focus

Answer path

Overview

Review signals

Follow-up prompts

Continue the section

Tech stacks

Skill areas

Suggest an improvement

Found this answer useful?