Error Handling
Error Handling
Common Errors
Error: sqlite3.OperationalError (database is locked)
- Cause: Concurrent access without proper timeout
- Solution: Use
timeout=30when connecting
Error: FTS5 not available
- Cause: SQLite compiled without FTS5 support
- Solution: Upgrade SQLite or use FTS4 fallback
Error: Empty search results
- Cause: FTS index not synced with data
- Solution: Rebuild FTS index with
INSERT INTO chunks_fts(chunks_fts) VALUES('rebuild')
Error: Memory issues with large collections
- Cause: Loading all chunks at once
- Solution: Process in batches, commit every 500 documents