Unity游戏开发中SQLite数据库的集成与优化实践

1. 为什么Unity开发者需要掌握SQLite

在Unity项目开发中，数据持久化存储是每个开发者都无法回避的问题。PlayerPrefs虽然简单易用，但面对复杂数据结构时就显得力不从心。这时候，SQLite就成为了Unity开发者的首选解决方案。

SQLite作为轻量级的关系型数据库，具有几个显著优势：首先，它是无服务器的，整个数据库就是一个单独的文件，非常适合移动端和桌面端应用；其次，它支持标准的SQL语法，可以执行复杂的查询操作；最重要的是，它的性能表现非常出色，在移动设备上也能流畅运行。

我在多个Unity商业项目中都采用了SQLite作为数据存储方案。相比其他方案，SQLite最大的优势在于它的灵活性和稳定性。比如在一个RPG游戏中，我们需要存储玩家背包中的数百件物品及其属性，使用SQLite可以轻松实现复杂的查询和更新操作，而不会像PlayerPrefs那样随着数据量增加而性能下降。

2. Unity中集成SQLite的完整流程

2.1 准备工作与环境配置

要在Unity中使用SQLite，首先需要准备SQLite的.NET驱动。最常用的方案是使用Mono.Data.Sqlite，这是Mono项目提供的SQLite实现，已经内置在Unity中。

对于Unity 2018及更新版本，推荐使用System.Data.SQLite，它提供了更好的性能和更完整的SQLite功能支持。可以通过NuGet包管理器获取，或者直接从SQLite官网下载预编译的二进制文件。

注意：如果项目需要跨平台（特别是iOS），必须确保使用的SQLite版本与目标平台兼容。我曾经在一个项目中因为使用了不兼容的SQLite版本，导致iOS版本崩溃，后来不得不重新编译SQLite源码。

2.2 导入SQLite到Unity项目

将SQLite集成到Unity项目中的步骤如下：

1. 创建Plugins文件夹（如果不存在）：在Assets目录下创建Plugins文件夹
2. 添加SQLite库文件：根据目标平台添加对应的SQLite库文件
   • Windows：sqlite3.dll
   • macOS：libsqlite3.dylib
   • Android：libsqlite3.so
   • iOS：需要自定义编译
3. 添加C#封装：将System.Data.SQLite.dll或Mono.Data.Sqlite.dll放入Plugins文件夹

对于Android平台，还需要在Player Settings中启用Internet Access权限，即使你只是本地使用SQLite。这是一个常见的坑，我曾经花了半天时间排查为什么Android上SQLite无法正常工作，最后发现是这个权限问题。

3. SQLite基础操作实战

3.1 创建和连接数据库

在Unity中创建和连接SQLite数据库的代码如下：

csharp复制using System.Data;
using Mono.Data.Sqlite;

public class SQLiteManager 
{
    private string dbPath;
    private IDbConnection dbConnection;
    
    public SQLiteManager(string databaseName)
    {
        // 在Unity编辑器中，数据库路径是Assets同级的目录
        #if UNITY_EDITOR
        dbPath = "URI=file:" + Application.dataPath + "/../" + databaseName;
        #else
        // 在移动设备上，数据库存储在持久化数据路径
        dbPath = "URI=file:" + Application.persistentDataPath + "/" + databaseName;
        #endif
        
        dbConnection = new SqliteConnection(dbPath);
        dbConnection.Open();
    }
}

这个代码片段展示了如何在不同平台下正确处理数据库路径。在编辑器模式下，我们将数据库放在Assets同级目录，方便调试；而在真机运行时，则使用Application.persistentDataPath，这是移动设备上唯一可写的目录。

3.2 创建表和插入数据

创建表和执行SQL命令的基本模式如下：

csharp复制public void CreateTable()
{
    IDbCommand dbCommand = dbConnection.CreateCommand();
    string sqlQuery = "CREATE TABLE IF NOT EXISTS PlayerData (" +
                      "id INTEGER PRIMARY KEY AUTOINCREMENT, " +
                      "name TEXT NOT NULL, " +
                      "level INTEGER DEFAULT 1, " +
                      "experience INTEGER DEFAULT 0)";
    
    dbCommand.CommandText = sqlQuery;
    dbCommand.ExecuteNonQuery();
}

public void InsertPlayerData(string playerName)
{
    IDbCommand dbCommand = dbConnection.CreateCommand();
    string sqlQuery = "INSERT INTO PlayerData (name) VALUES (@name)";
    
    dbCommand.CommandText = sqlQuery;
    
    // 使用参数化查询防止SQL注入
    SqliteParameter nameParam = new SqliteParameter("@name", playerName);
    dbCommand.Parameters.Add(nameParam);
    
    dbCommand.ExecuteNonQuery();
}

这里有几个关键点需要注意：首先，使用IF NOT EXISTS可以避免重复创建表导致的错误；其次，使用参数化查询（@name）而不是字符串拼接，可以有效防止SQL注入攻击；最后，为字段设置合理的默认值可以减少代码复杂度。

4. 高级查询与性能优化

4.1 执行复杂查询

SQLite的强大之处在于它支持复杂的SQL查询。以下是一个多表联合查询的示例：

csharp复制public List<PlayerItem> GetPlayerInventory(int playerId)
{
    List<PlayerItem> inventory = new List<PlayerItem>();
    
    IDbCommand dbCommand = dbConnection.CreateCommand();
    string sqlQuery = "SELECT i.item_id, i.name, i.type, pi.quantity " +
                      "FROM PlayerItems pi " +
                      "JOIN Items i ON pi.item_id = i.item_id " +
                      "WHERE pi.player_id = @playerId";
    
    dbCommand.CommandText = sqlQuery;
    dbCommand.Parameters.Add(new SqliteParameter("@playerId", playerId));
    
    IDataReader reader = dbCommand.ExecuteReader();
    while (reader.Read())
    {
        PlayerItem item = new PlayerItem();
        item.ItemId = reader.GetInt32(0);
        item.Name = reader.GetString(1);
        item.Type = reader.GetString(2);
        item.Quantity = reader.GetInt32(3);
        inventory.Add(item);
    }
    
    reader.Close();
    return inventory;
}

这种多表关联查询在游戏开发中非常常见，比如获取玩家背包中的所有物品及其详细信息。使用JOIN可以避免多次查询数据库，显著提高性能。

4.2 事务处理和批量操作

当需要执行大量数据库操作时，使用事务可以极大提高性能：

csharp复制public void SaveAllPlayerData(PlayerData data)
{
    IDbTransaction transaction = dbConnection.BeginTransaction();
    try
    {
        IDbCommand dbCommand = dbConnection.CreateCommand();
        dbCommand.Transaction = transaction;
        
        // 更新玩家基础数据
        dbCommand.CommandText = "UPDATE PlayerData SET level=@level, experience=@exp WHERE id=@id";
        dbCommand.Parameters.Add(new SqliteParameter("@level", data.Level));
        dbCommand.Parameters.Add(new SqliteParameter("@exp", data.Experience));
        dbCommand.Parameters.Add(new SqliteParameter("@id", data.PlayerId));
        dbCommand.ExecuteNonQuery();
        
        // 清空玩家物品
        dbCommand.CommandText = "DELETE FROM PlayerItems WHERE player_id=@id";
        dbCommand.Parameters.Clear();
        dbCommand.Parameters.Add(new SqliteParameter("@id", data.PlayerId));
        dbCommand.ExecuteNonQuery();
        
        // 批量插入新物品
        dbCommand.CommandText = "INSERT INTO PlayerItems (player_id, item_id, quantity) VALUES (@id, @itemId, @qty)";
        foreach (var item in data.Inventory)
        {
            dbCommand.Parameters.Clear();
            dbCommand.Parameters.Add(new SqliteParameter("@id", data.PlayerId));
            dbCommand.Parameters.Add(new SqliteParameter("@itemId", item.ItemId));
            dbCommand.Parameters.Add(new SqliteParameter("@qty", item.Quantity));
            dbCommand.ExecuteNonQuery();
        }
        
        transaction.Commit();
    }
    catch (Exception ex)
    {
        transaction.Rollback();
        Debug.LogError("Save player data failed: " + ex.Message);
        throw;
    }
}

在这个例子中，我们将更新玩家数据、清空物品栏和重新填充物品这三个操作放在一个事务中。这样做有两个好处：一是保证数据一致性，要么全部成功要么全部失败；二是显著提高性能，因为SQLite每次写入磁盘都需要同步文件系统，而使用事务可以将多次写入合并为一次。

5. 跨平台兼容性问题与解决方案

5.1 iOS平台的特殊处理

iOS平台对SQLite的支持有一些特殊要求。最大的问题是iOS的沙盒机制和文件权限系统。以下是在iOS上使用SQLite的注意事项：

1. 数据库文件必须放在Application.persistentDataPath目录下，其他位置不可写
2. 需要使用正确的SQLite版本，推荐使用Xcode自带的libsqlite3.dylib
3. 在Unity中，需要为iOS平台单独编译SQLite插件

我曾经遇到一个棘手的问题：在iOS设备上，当应用进入后台时，系统可能会清理临时文件，如果此时数据库连接没有正确关闭，可能导致数据库损坏。解决方案是在AppController.mm中添加以下代码：

objectivec复制- (void)applicationDidEnterBackground:(UIApplication *)application
{
    // 关闭所有数据库连接
    [[NSNotificationCenter defaultCenter] postNotificationName:@"CloseDatabaseConnections" object:nil];
}

然后在Unity C#代码中监听这个通知：

csharp复制#if UNITY_IOS
void OnEnable()
{
    #if UNITY_IOS && !UNITY_EDITOR
    UnityEngine.iOS.NotificationServices.RegisterForNotifications(
        UnityEngine.iOS.NotificationType.Alert |
        UnityEngine.iOS.NotificationType.Badge |
        UnityEngine.iOS.NotificationType.Sound);
    
    UnityEngine.iOS.NotificationServices.AddNotificationObserver(
        "CloseDatabaseConnections", 
        (notification) => {
            if (dbConnection != null && dbConnection.State == ConnectionState.Open)
            {
                dbConnection.Close();
            }
        });
    #endif
}
#endif

5.2 Android平台的优化技巧

Android平台上使用SQLite也有几个需要注意的地方：

1. 数据库文件默认会存储在/data/data//databases/目录下
2. 首次运行应用时，可能需要从StreamingAssets复制预置数据库
3. 多线程访问时需要处理好同步问题

一个实用的技巧是使用SQLiteOpenHelper模式，虽然Unity中不能直接使用Android的SQLiteOpenHelper，但我们可以实现类似的逻辑：

csharp复制public class SQLiteHelper
{
    private static readonly object lockObj = new object();
    
    public static void InitializeDatabase(string dbName)
    {
        string dbPath = Path.Combine(Application.persistentDataPath, dbName);
        
        // 如果数据库不存在，从StreamingAssets复制
        if (!File.Exists(dbPath))
        {
            lock (lockObj)
            {
                if (!File.Exists(dbPath))
                {
                    string sourcePath = Path.Combine(Application.streamingAssetsPath, dbName);
                    
                    #if UNITY_ANDROID && !UNITY_EDITOR
                    // Android上StreamingAssets是压缩包，需要使用WWW加载
                    WWW reader = new WWW(sourcePath);
                    while (!reader.isDone) { }
                    File.WriteAllBytes(dbPath, reader.bytes);
                    #else
                    File.Copy(sourcePath, dbPath);
                    #endif
                }
            }
        }
    }
}

这个Helper类解决了两个常见问题：一是数据库初始化时的线程安全问题，二是Android平台上从StreamingAssets复制文件的特殊处理。

6. 实战经验与性能调优

6.1 数据库设计最佳实践

在Unity项目中使用SQLite时，合理的数据库设计至关重要。以下是我总结的几个最佳实践：

1. 为所有表添加INTEGER PRIMARY KEY字段，SQLite会将其作为行ID（rowid）的别名，可以显著提高查询速度
2. 合理使用索引，但不要过度索引。只为经常用于查询条件的列创建索引
3. 将频繁更新的数据和不常更新的数据分开存储在不同的表中
4. 对于游戏中的配置数据，考虑使用预填充的只读数据库

一个常见的错误是在游戏存档中存储大量重复的配置数据。比如在一个RPG游戏中，每个玩家物品都完整存储物品的所有属性。更好的做法是只存储物品ID和数量，物品属性存储在单独的配置表中。

6.2 性能监控与优化

SQLite虽然性能很好，但在移动设备上仍需注意优化。以下是一些性能调优技巧：

1. 使用EXPLAIN QUERY PLAN分析SQL语句的执行计划
2. 对于复杂查询，考虑使用预编译语句（prepared statements）
3. 定期执行VACUUM命令整理数据库碎片
4. 合理设置PRAGMA synchronous和PRAGMA journal_mode

我曾经优化过一个性能问题的案例：游戏在存档时会出现明显的卡顿。通过分析发现是因为每次保存都执行了几十条单独的UPDATE语句。解决方案是改用批量更新和事务，将保存时间从200ms降低到了20ms。

以下是性能监控的示例代码：

csharp复制public void LogQueryPlan(string sql)
{
    IDbCommand cmd = dbConnection.CreateCommand();
    cmd.CommandText = "EXPLAIN QUERY PLAN " + sql;
    
    IDataReader reader = cmd.ExecuteReader();
    while (reader.Read())
    {
        Debug.Log($"Query Plan: {reader.GetString(3)}");
    }
    reader.Close();
}

这个工具方法可以帮助你理解SQLite是如何执行你的查询的，对于优化复杂查询非常有帮助。

7. 常见问题与解决方案

7.1 数据库锁定问题

在多线程环境下使用SQLite时，经常会遇到"database is locked"错误。这是因为SQLite的写操作会锁定整个数据库文件。解决方案包括：

1. 使用单一数据库连接，或者确保每个线程使用独立的连接
2. 实现连接池模式
3. 对于读多写少的场景，使用WAL（Write-Ahead Logging）模式

以下是一个线程安全的数据库访问封装示例：

csharp复制public class ThreadSafeSQLite
{
    private static ThreadLocal<IDbConnection> threadLocalConnection = new ThreadLocal<IDbConnection>();
    private static string connectionString;
    
    public static void Initialize(string dbPath)
    {
        connectionString = "URI=file:" + dbPath;
    }
    
    public static IDbConnection GetConnection()
    {
        if (threadLocalConnection.Value == null || 
            threadLocalConnection.Value.State != ConnectionState.Open)
        {
            threadLocalConnection.Value = new SqliteConnection(connectionString);
            threadLocalConnection.Value.Open();
            
            // 设置更长的忙等待时间
            ((SqliteConnection)threadLocalConnection.Value).BusyTimeout = 5000;
        }
        return threadLocalConnection.Value;
    }
}

7.2 数据库损坏与恢复

虽然SQLite非常稳定，但在极端情况下（如应用崩溃、设备断电）数据库仍可能损坏。预防措施包括：

1. 定期备份数据库文件
2. 使用PRAGMA integrity_check检查数据库完整性
3. 实现自动恢复机制

以下是一个简单的数据库恢复方案：

csharp复制public bool CheckDatabaseIntegrity()
{
    IDbCommand cmd = dbConnection.CreateCommand();
    cmd.CommandText = "PRAGMA integrity_check";
    IDataReader reader = cmd.ExecuteReader();
    
    if (reader.Read())
    {
        string result = reader.GetString(0);
        return result == "ok";
    }
    return false;
}

public void RestoreFromBackup()
{
    string backupPath = Path.Combine(Application.persistentDataPath, "backup.db");
    string dbPath = Path.Combine(Application.persistentDataPath, "game.db");
    
    if (File.Exists(backupPath))
    {
        File.Copy(backupPath, dbPath, true);
    }
}

public void CreateBackup()
{
    string backupPath = Path.Combine(Application.persistentDataPath, "backup.db");
    string dbPath = Path.Combine(Application.persistentDataPath, "game.db");
    
    if (File.Exists(dbPath))
    {
        File.Copy(dbPath, backupPath, true);
    }
}

在实际项目中，我通常会实现一个定时备份机制，比如每天凌晨自动备份一次数据库，或者在每次重要操作前创建临时备份。