use sqlx::{SqlitePool, sqlite::SqlitePoolOptions}; use crate::config::Config; use tokio::sync::Mutex; pub struct Database { pub(crate) pool: SqlitePool, pub config: Config, /// 写互斥锁:单协程串行化所有写操作,消除 WAL 锁争用 pub(crate) write_lock: Mutex<()>, } impl Database { pub async fn new(config: &Config) -> Result { let url = &config.database.url; let file_path = if url.starts_with("sqlite:") { &url[7..] } else { url }; if let Some(parent) = std::path::Path::new(file_path).parent() { if !parent.exists() { std::fs::create_dir_all(parent)?; } } if !std::path::Path::new(file_path).exists() { std::fs::File::create(file_path)?; println!("创建新的数据库文件: {}", file_path); } let pool = SqlitePoolOptions::new() .max_connections(2) // 写串行化后无需过多连接 .min_connections(1) .acquire_timeout(std::time::Duration::from_secs(5)) .idle_timeout(std::time::Duration::from_secs(300)) .max_lifetime(std::time::Duration::from_secs(1800)) .connect(url) .await?; // SQLite 高并发优化 PRAGMA sqlx::query("PRAGMA journal_mode=WAL;").execute(&pool).await?; sqlx::query("PRAGMA synchronous=NORMAL;").execute(&pool).await?; sqlx::query("PRAGMA busy_timeout=5000;").execute(&pool).await?; // 等待 5s 避免 SQLITE_BUSY sqlx::query("PRAGMA wal_autocheckpoint=1000;").execute(&pool).await?; // 小 WAL → 短 checkpoint sqlx::query("PRAGMA journal_size_limit=67108864;").execute(&pool).await?; // WAL 上限 64MB sqlx::query("PRAGMA cache_size=-64000;").execute(&pool).await?; // 64KB 页缓存 sqlx::query("PRAGMA mmap_size=268435456;").execute(&pool).await?; sqlx::query("PRAGMA temp_store=MEMORY;").execute(&pool).await?; sqlx::query("PRAGMA foreign_keys=ON;").execute(&pool).await?; sqlx::migrate!("./migrations").run(&pool).await?; let db = Database { pool, config: config.clone(), write_lock: Mutex::new(()) }; db.ensure_image_count_field().await?; Ok(db) } /// 执行 WAL checkpoint(TRUNCATE),将 WAL 完全合并回主文件并清理 -wal / -shm 文件 /// /// 应在服务优雅关闭时调用,确保数据库文件处于干净一致的状态, /// 避免下次启动时 WAL 恢复带来的额外开销。 pub async fn wal_checkpoint(&self) { let _guard = self.write_lock.lock().await; // wal_checkpoint 返回一行 (busy, log, checkpointed),只关注结果忽略返回值 match sqlx::query("PRAGMA wal_checkpoint(TRUNCATE)") .execute(&self.pool).await { Ok(_) => println!("[DB] WAL checkpoint(TRUNCATE) 完成,数据库文件已合并"), Err(e) => eprintln!("[DB] WAL checkpoint 失败: {}", e), } } /// 确保 image_count 字段存在 async fn ensure_image_count_field(&self) -> Result<(), sqlx::Error> { let has_col = sqlx::query_scalar::<_, i64>( "SELECT COUNT(*) FROM pragma_table_info('albums') WHERE name = 'image_count'" ).fetch_one(&self.pool).await.unwrap_or(0); if has_col == 0 { sqlx::query("ALTER TABLE albums ADD COLUMN image_count INTEGER DEFAULT 0").execute(&self.pool).await?; println!("✅ image_count 字段已添加"); } else { println!("ℹ️ image_count字段已存在,跳过初始化"); } Ok(()) } }