Add robust error handling and logging for table creation

Author: crocodilestick

CONTRIBUTORS

@@ -293,7 +293,7 @@ Copyright (C) 2024-2025 Calibre-Web Automated contributors
 - whilenot-dev (1 commits)
 - Wolfenk (1 commits)
 - wolviex (1 commits)
-- Wouter Dijk (anon) (1 commits)
+- wouterdijk-cpu (1 commits)
 - WouterKoch (1 commits)
 - wuwei-12138 (1 commits)
 - xybydy (1 commits)
@@ -303,7 +303,7 @@ Copyright (C) 2024-2025 Calibre-Web Automated contributors
 - zhiyue (1 commits)
 # Fork Contributors (crocodilestick/calibre-web-automated)
 
-- crocodilestick (782 commits)
+- crocodilestick (783 commits)
 - jmarmstrong1207 (73 commits)
 - demitrix (30 commits)
 - sirwolfgang (29 commits)

cps/db.py

@@ -738,11 +738,20 @@ def setup_db(cls, config_calibre_dir, app_db_path):
 
         # Ensure progress syncing tables exist in metadata.db (book checksums)
         # Use a direct connection to ensure the table is created in the file, not in-memory
-        from .progress_syncing.models import ensure_calibre_db_tables
         try:
-            with sqlite3.connect(dbpath, timeout=30) as direct_conn:
-                ensure_calibre_db_tables(direct_conn)
+            # Import inside try block to handle potential circular imports or missing modules gracefully
+            from .progress_syncing.models import ensure_calibre_db_tables
+            
+            # Verify dbpath exists
+            if os.path.exists(dbpath):
+                with sqlite3.connect(dbpath, timeout=30) as direct_conn:
+                    ensure_calibre_db_tables(direct_conn)
+            else:
+                log.error(f"Cannot ensure tables: metadata.db not found at {dbpath}")
         except Exception as e:
+            # Log to both app log and stderr to ensure visibility in Docker logs
+            import sys
+            sys.stderr.write(f"ERROR: Failed to ensure progress syncing tables: {e}\n")
             log.error(f"Failed to ensure progress syncing tables: {e}")
 
         cls._init = True