Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 5 additions & 23 deletions debugging/error-codes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,24 +6,12 @@

This reference documents PowerSync error codes organized by component, with troubleshooting suggestions for developers. Use the search bar to look up specific error codes (e.g., `PSYNC_R0001`).

# PSYNC_Rxxxx: Sync Rules issues
# PSYNC_Rxxxx: Sync Config issues

Check warning on line 9 in debugging/error-codes.mdx

View check run for this annotation

Mintlify / Mintlify Validation (powersync) - vale-spellcheck

debugging/error-codes.mdx#L9

Did you really mean 'PSYNC_Rxxxx'?

- **PSYNC_R0001**:
Catch-all [Sync Rules](/sync/rules/overview) parsing error, if no more specific error is available

## PSYNC_R11xx: YAML syntax issues

## PSYNC_R12xx: YAML structure (schema) issues

## PSYNC_R21xx: SQL syntax issues

## PSYNC_R22xx: SQL supported feature issues

## PSYNC_R23xx: SQL schema mismatch issues

## PSYNC_R24xx: SQL security warnings
Catch-all [Sync Config](/sync/overview) parsing error, if no more specific error is available

# PSYNC_Sxxxx: Service issues

Check warning on line 14 in debugging/error-codes.mdx

View check run for this annotation

Mintlify / Mintlify Validation (powersync) - vale-spellcheck

debugging/error-codes.mdx#L14

Did you really mean 'PSYNC_Sxxxx'?

- **PSYNC_S0001**:
Internal assertion.
Expand All @@ -48,7 +36,7 @@
this cannot be replicated.

- **PSYNC_S1003**:
Sync rules have been locked by another process for replication.
Replication stream has been locked by another process for replication.

This error is normal in some circumstances:
1. In some cases, if a process was forcefully terminated, this error may occur for up to a minute.
Expand Down Expand Up @@ -154,8 +142,6 @@
An alternative is to create explicit policies for the replication role. If you have done that,
you may ignore this warning.

## PSYNC_S12xx: MySQL replication issues

## PSYNC_S13xx: MongoDB replication issues

- **PSYNC_S1301**:
Expand Down Expand Up @@ -322,7 +308,7 @@
## PSYNC_S23xx: Sync API errors

- **PSYNC_S2302**:
No sync rules available.
No Sync Config available.

This error may happen if:
1. Sync Streams/Rules have not been deployed.
Expand Down Expand Up @@ -353,10 +339,6 @@
- **PSYNC_S2404**:
Query failure on the storage database. See error details for more information.

## PSYNC_S23xx: Sync API errors - Postgres Storage

## PSYNC_S3xxx: Service configuration issues

## PSYNC_S31xx: Auth configuration issues

- **PSYNC_S3102**:
Expand All @@ -378,7 +360,7 @@
This error may indicate a bug in the service code.

- **PSYNC_S4104**:
No active sync rules.
No active Sync Config.

- **PSYNC_S4105**:
Sync Streams API disabled.
Expand Down