.NET MAUI应用LiteDB报错‘empty page must be defined as empty type’求助

针对你在.NET MAUI中使用LiteDB同步数据时，删除集合后重插出现的间歇性错误，以下是具体排查和解决步骤：

1. 确保数据库操作的串行性 #

错误可能来自并发操作：DropCollection和Insert操作在不同线程同时执行，导致数据库文件状态不一致。

• 所有数据库操作（删除、插入）需通过同一个LiteDatabase实例执行，避免频繁创建/销毁实例：

  // 全局单例实例示例
  private static LiteDatabase _dbInstance;
  public static LiteDatabase GetDbInstance()
  {
      if (_dbInstance == null || _dbInstance.ConnectionState == ConnectionState.Closed)
      {
          _dbInstance = new LiteDatabase(UserDatabasePath);
      }
      return _dbInstance;
  }
  
  // 删除集合
  using (var db = GetDbInstance())
  {
      db.DropCollection(collectionName);
      // 强制刷盘，确保删除操作彻底完成
      db.Checkpoint();
  }
  
  // 插入数据
  using (var db = GetDbInstance())
  {
      var collection = db.GetCollection<CompressorModel>(collectionName);
      collection.Insert(compressors);
  }
  

2. 启用数据库自动修复与校验 #

DropCollection可能残留无效页，可通过连接字符串开启自动修复和校验：

var connString = new ConnectionString
{
    Filename = UserDatabasePath,
    AutoRepair = true, // 自动修复损坏的数据库
    Checkpoint = TimeSpan.FromSeconds(1), // 频繁刷盘确保操作持久化
    Connection = ConnectionType.Shared // 共享连接避免多实例冲突
};

using (var db = new LiteDatabase(connString))
{
    db.DropCollection(collectionName);
}

3. 替换DropCollection为清空操作 #

删除集合会重建集合和索引，可能触发页面异常；改用DeleteAll()清空数据保留集合结构：

using (var db = new LiteDatabase(UserDatabasePath))
{
    var collection = db.GetCollection<CompressorModel>(collectionName);
    collection.DeleteAll(); // 清空所有数据，保留集合和索引配置
}

4. 检查CompressorModel的Bson映射与索引 #

错误堆栈指向索引创建阶段，需排查实体类的索引配置：

• 检查是否有字段被标记为[BsonIndex]但可能出现null值或异常序列化结果：

  public class CompressorModel
  {
      // 若字段允许null，确保索引不强制非空
      [BsonIndex(false)] // false表示非唯一索引，允许null
      public string? SomeField { get; set; }
  }
  

• 尝试移除自定义索引，仅保留默认主键，测试是否还出现错误，逐步排查异常索引字段。

5. 手动修复数据库文件 #

若数据库文件已损坏，可执行手动修复：

// 修复数据库并生成新文件
LiteDatabase.Repair(UserDatabasePath, $"{UserDatabasePath}_repaired");
// 替换原文件
File.Delete(UserDatabasePath);
File.Move($"{UserDatabasePath}_repaired", UserDatabasePath);

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