Swift中使用单例模式创建SQLite全局DB连接的初始化问题

核心问题原因 #

你之前收到报错是因为静态方法属于类本身，无法直接访问实例层面的成员变量，同时你原有App初始化逻辑的判断写反了：初始状态下conn为nil，判断if conn != nil才调用open永远不会触发连接创建。

修正后代码 #

单例类实现 #

import SQLite

enum SQLiteDBError: Error {
    case couldNotOpenConnection
    case dbPathNotConfigured
}

class DBConnection {
    static let shared = DBConnection()
    // 连接改为实例属性，对外只读，符合单例设计规范
    private(set) var conn: Connection?
    // 静态存储数据库路径，启动时提前配置
    private static var dbPath: URL?
    
    private init() {
        // 初始化时自动调用私有open方法，无需外部显式调用
        do {
            try openDB()
        } catch {
            print("数据库连接失败: \(error)")
        }
    }
    
    // 私有实例方法，直接操作当前实例的conn属性
    private func openDB() throws {
        guard let dbPath = Self.dbPath else {
            throw SQLiteDBError.dbPathNotConfigured
        }
        do {
            conn = try Connection("\(dbPath)/db.sqlite3")
            print("数据库连接打开成功")
        } catch {
            throw SQLiteDBError.couldNotOpenConnection
        }
    }
    
    // 对外暴露的初始化配置方法，App启动时调用一次即可
    static func config(dbPath: URL) {
        Self.dbPath = dbPath
        // 触发单例初始化，自动执行连接逻辑
        _ = shared
    }
}

App入口初始化逻辑 #

@main
struct MyApp: App {
    init() {
        let docPath = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
        // 只需调用一次配置方法，内部自动完成单例创建、连接打开
        DBConnection.config(dbPath: docPath)
    }
    // ... 其余App逻辑
}

使用方式 #

后续业务侧需要调用数据库连接时，直接访问单例的实例属性即可：
let db = DBConnection.shared.conn

内容的提问来源于stack exchange，提问作者Paul