Microsoft.Data.Sqlite中ReadWriteCreate模式无法重建数据库的问题

问题场景 #

检测到SQLite数据库损坏后，尝试通过以下流程删除并重建数据库，但出现异常：

1. 使用Mode=ReadWriteCreate创建并打开数据库连接
2. 关闭连接后删除数据库文件
3. 再次执行步骤1重建数据库

实际结果：数据库文件未被重新创建，后续执行查询或事务时触发SQLite错误26：file is not a database。

额外发现：若删除connection.Close()代码行，数据库能正常重建，但长期持有连接并非合理方案。

运行环境：macOS 12.3.1，.NET 6.0.402 SDK

复现代码 #

using System;
using System.IO;
using Microsoft.Data.Sqlite;

namespace PotentialSqliteBug
{
    class Program
    {
        private static string DbPath = "/Users/jbickle/Downloads/SomeDatabase.sqlite";
        private static string ConnectionString = $"Data Source={DbPath};Mode=ReadWriteCreate";
            
        static void Main(string[] args)
        {
            using var connection = new SqliteConnection(ConnectionString);
            connection.Open();

            if (File.Exists(DbPath))
                Console.WriteLine("The database exists after connection was opened.");
            else
            {
                Console.WriteLine("The database DOES NOT exist after connection was opened.");
                return;
            }

            connection.Close();
            
            File.Delete(DbPath);
            if (File.Exists(DbPath))
                Console.WriteLine("The database unexpectedly exists after attempting to delete it.");
            else
                Console.WriteLine("The database no longer exists after attempting to delete it, as expected.");
            
            using var secondConnection = new SqliteConnection(ConnectionString);
            secondConnection.Open();

            if (File.Exists(DbPath))
                Console.WriteLine("The database exists after connection was opened.");
            else
                Console.WriteLine("The database DOES NOT exist after connection was opened.");
        }
    }
}

运行输出 #

The database exists after connection was opened.
The database no longer exists after attempting to delete it, as expected.
The database DOES NOT exist after connection was opened.

原因分析 #

问题根源在于Microsoft.Data.Sqlite的连接池机制：

• 即使调用了connection.Close()，连接池会回收该连接而非立即关闭底层的SQLite文件句柄
• 在macOS等类Unix系统中，若文件被进程持有句柄，执行File.Delete()后文件只是被标记为待删除，并未真正从文件系统中移除
• 当创建第二个连接时，连接池复用了之前的连接，该连接对应的文件已被标记删除，无法正常创建新的数据库文件

解决方案 #

方案1：清空连接池（推荐） #

在关闭第一个连接后，调用SqliteConnection.ClearAllPools()强制清空所有连接池，释放底层的文件句柄，确保删除操作彻底生效。

修改后的核心代码片段：

connection.Close();
// 清空连接池，释放所有底层SQLite句柄
SqliteConnection.ClearAllPools();

File.Delete(DbPath);

方案2：禁用连接池 #

在连接字符串中添加Pooling=false参数，关闭连接池功能，这样每次关闭连接都会立即释放底层文件句柄，不会复用连接。

修改后的连接字符串：

private static string ConnectionString = $"Data Source={DbPath};Mode=ReadWriteCreate;Pooling=false";

方案3：确保连接彻底释放 #

依赖using块的自动释放机制（using块结束时会自动调用Dispose()，比手动调用Close()更彻底），配合清空连接池，避免手动管理连接状态的误差。

调整后的代码示例：

using (var connection = new SqliteConnection(ConnectionString))
{
    connection.Open();
    // 执行初始操作
}
// using块结束后自动释放连接，再清空连接池
SqliteConnection.ClearAllPools();

File.Delete(DbPath);

using (var secondConnection = new SqliteConnection(ConnectionString))
{
    secondConnection.Open();
    // 重建数据库后的操作
}

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