如何避免SQLite创建表时出现含TypeInitializationException的AggregateException

咱们先来拆解这个问题的核心：你遇到的AggregateException其实是个“背锅侠”，真正的罪魁祸首是它包裹的TypeInitializationException，而且这个异常是在SQLite.SQLiteConnection的静态初始化阶段触发的。结合你已经移除DateTime类型、仅用string和int的情况，我给你梳理几个针对性的排查和解决步骤：

第一步：先挖出真正的异常详情 #

AggregateException和TypeInitializationException都是“包装类”，真正的错误细节藏在内部异常链里。你可以在捕获异常时，逐层打印内部异常信息，这是定位问题的关键：

try
{
    // 你的创建表、初始化数据库的代码
}
catch (AggregateException ex)
{
    var currentEx = ex.InnerException;
    while (currentEx != null)
    {
        // 打印异常信息和堆栈，方便定位
        Console.WriteLine($"真实异常：{currentEx.Message}");
        Console.WriteLine($"堆栈跟踪：{currentEx.StackTrace}");
        currentEx = currentEx.InnerException;
    }
}

比如可能是SQLite原生库没加载、实体类配置错误，或者路径权限不足，这些都会被包装成外层的AggregateException。

第二步：检查数据库路径的有效性与权限 #

你的数据库路径是/data/user/0/com.companyname.AppName/files/fn.db3，这是Android应用的私有文件目录，理论上应用默认有读写权限，但还是要确认几点：

• 尽量不要硬编码路径！改用Android上下文获取私有目录路径，避免包名变化、多用户模式等问题：

  var dbDir = Android.App.Application.Context.GetFilesDir().AbsolutePath;
  var dbPath = Path.Combine(dbDir, "fn.db3");
  

• 尝试先手动创建空文件，验证路径是否可写：

  if (!File.Exists(dbPath))
  {
      using (var fileStream = File.Create(dbPath)) { }
  }
  

  如果这一步报错，说明路径权限有问题，需要检查应用的权限配置或者ROM的特殊限制。

第三步：排查业务对象（BO）的实体配置 #

虽然你已经移除了DateTime，但实体类的其他配置错误也会导致SQLite无法生成表：

• 必须标记主键：SQLite要求每个表都有主键，你的实体类必须有一个标记[PrimaryKey]的公共属性（int类型可以加[AutoIncrement]实现自增）：

  public class YourBusinessObject
  {
      [PrimaryKey, AutoIncrement]
      public int Id { get; set; } // 必须有主键
      public string YourStringProp { get; set; }
      public int YourIntProp { get; set; }
  }
  

• 检查属性名称是否用了SQLite的保留字：比如Order、User、Group这些都是SQLite的保留字，遇到这种情况需要用[Column]特性重命名：

  [Column("UserInfo")]
  public string User { get; set; }
  

• 确保所有需要映射的属性都是public访问权限：SQLite需要读取公共属性来生成表结构，私有或保护属性会被忽略。

第四步：检查SQLite.NET的平台适配与初始化 #

TypeInitializationException经常发生在SQLiteConnection的静态构造函数阶段，大多是因为缺少平台特定的原生库或者初始化错误：

• 如果你用的是sqlite-net-pcl，确保已经安装了对应平台的适配包：比如Android平台需要SQLite.Net-Platform-Android，并且所有SQLite相关包的版本要一致，避免版本冲突。
• 初始化连接时指定明确的打开标志，确保读写权限：

  var connection = new SQLiteConnection(dbPath, SQLiteOpenFlags.ReadWrite | SQLiteOpenFlags.Create);
  

• 不要在应用启动的早期（比如Application的静态构造函数）初始化数据库，这时候Android上下文可能还没准备好，建议在Activity的OnCreate方法之后再创建连接。

如果按照上面的步骤排查后还是解决不了，把你挖到的真实异常信息、实体类代码，还有数据库初始化的核心代码贴出来，这样能更精准地定位问题。

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