C#搭配Dapper连接SQLite3的5个常见报错及解决方法（附完整代码）

C#搭配Dapper连接SQLite3的5个常见报错及解决方法（附完整代码）

在.NET生态中，SQLite因其轻量级和零配置特性成为本地数据存储的热门选择，而Dapper作为高性能的微型ORM工具，二者结合能显著提升开发效率。但实际开发中，从NuGet包依赖冲突到连接字符串配置，新手常会陷入各种"陷阱"。本文将解剖五个最具代表性的错误场景，提供可直接复用的解决方案。

1. 连接字符串配置引发的"幽灵数据库"问题

许多开发者第一次遇到SQLite时会惊讶地发现：即使连接字符串指向不存在的数据库文件，程序也不会报错。这是因为SQLite默认会自动创建新数据库文件。这种静默行为可能导致数据丢失风险——你以为在连接已有数据库，实则创建了空的新库。

典型错误现象：

System.Data.SQLite.SQLiteException (0x80004005): unable to open database file

解决方案代码：

// 最佳实践连接字符串配置
const string connString = @"Data Source=C:\Data\mydb.db;Version=3;FailIfMissing=True;";

// 增加文件存在性检查
if (!File.Exists(@"C:\Data\mydb.db"))
{
    throw new FileNotFoundException("SQLite数据库文件不存在");
}

using var conn = new SQLiteConnection(connString);

关键参数说明：