Files
Charon/backend/internal/database/errors.go
GitHub Actions b015284165 feat: add SQLite database corruption guardrails
- Add PRAGMA quick_check on startup with warning log if corrupted
- Add corruption sentinel helpers for structured error detection
- Add backup retention (keep last 7, auto-cleanup after daily backup)
- Add GET /api/v1/health/db endpoint for orchestrator health checks

Prevents silent data loss and enables proactive corruption detection.
2025-12-17 16:53:38 +00:00

74 lines
2.1 KiB
Go

// Package database handles database connections, migrations, and error detection.
package database
import (
"strings"
"github.com/Wikid82/charon/backend/internal/logger"
"gorm.io/gorm"
)
// SQLite corruption error indicators
var corruptionPatterns = []string{
"malformed",
"corrupt",
"disk I/O error",
"database disk image is malformed",
"file is not a database",
"file is encrypted or is not a database",
"database or disk is full",
}
// IsCorruptionError checks if the given error indicates SQLite database corruption.
// It detects errors like "database disk image is malformed", "corrupt", and related I/O errors.
func IsCorruptionError(err error) bool {
if err == nil {
return false
}
errStr := strings.ToLower(err.Error())
for _, pattern := range corruptionPatterns {
if strings.Contains(errStr, strings.ToLower(pattern)) {
return true
}
}
return false
}
// LogCorruptionError logs a database corruption error with structured context.
// The context map can include fields like "operation", "table", "query", "monitor_id", etc.
func LogCorruptionError(err error, context map[string]interface{}) {
if err == nil {
return
}
entry := logger.Log().WithError(err)
// Add all context fields (range over nil map is safe)
for key, value := range context {
entry = entry.WithField(key, value)
}
// Mark as corruption error for alerting/monitoring
entry = entry.WithField("error_type", "database_corruption")
entry.Error("SQLite database corruption detected")
}
// CheckIntegrity runs PRAGMA quick_check and returns whether the database is healthy.
// Returns (healthy, message): healthy is true if database passes integrity check,
// message contains "ok" on success or the error/corruption message on failure.
func CheckIntegrity(db *gorm.DB) (healthy bool, message string) {
var result string
if err := db.Raw("PRAGMA quick_check").Scan(&result).Error; err != nil {
return false, "failed to run integrity check: " + err.Error()
}
// SQLite returns "ok" if the database passes integrity check
if strings.EqualFold(result, "ok") {
return true, "ok"
}
return false, result
}