docs: add debugging section for awaitTxId stalling issues #651
+89
−0
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add comprehensive debugging guide to help developers diagnose and fix the common issue where awaitTxId stalls or times out. This happens when pg_current_xact_id() is queried outside the mutation transaction, causing txid mismatches. The guide includes: - Explanation of the root cause (txid mismatch) - How to enable debug logging with localStorage.debug = '*' - Example logs showing both mismatched and matched txids - Correct pattern for querying txid inside sql.begin() - References to working examples in the codebase 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
|
More templates
@tanstack/angular-db
@tanstack/db
@tanstack/db-ivm
@tanstack/electric-db-collection
@tanstack/query-db-collection
@tanstack/react-db
@tanstack/rxdb-db-collection
@tanstack/solid-db
@tanstack/svelte-db
@tanstack/trailbase-db-collection
@tanstack/vue-db
commit: |
|
Size Change: 0 B Total Size: 75.2 kB ℹ️ View Unchanged
|
|
Size Change: 0 B Total Size: 1.47 kB ℹ️ View Unchanged
|
samwillis
approved these changes
Oct 7, 2025
| To diagnose txid issues, enable debug logging in your browser console: | ||
|
|
||
| ```javascript | ||
| localStorage.debug = '*' |
There was a problem hiding this comment.
Suggested change
| localStorage.debug = '*' | |
| localStorage.debug = 'ts/db:electric' |
Maybe mention this is using the debug module from npn and that there are more options for filtering?
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
awaitTxIdstalls or times outpg_current_xact_id()outside the mutation transaction, causing txid mismatchesWhat's included
localStorage.debug = '*'sql.begin()This addresses the frequent support issue where users report "2/3 times it just stalls, with no errors whatsoever" when using
awaitTxIdortx.isPersisted.promise.🤖 Generated with Claude Code