在 .NET MAUI 项目中直接使用 Dapper 是可行的，但需注意平台限制和数据库访问方式——Dapper 本身是轻量级 ORM，不处理连接管理或跨平台数据库驱动，它依赖 ADO.NET 提供的
IDbConnection。MAUI 是客户端 UI 框架，**不支持直接连接 SQL Server、PostgreSQL 等服务端数据库**，因此 Dapper 在 MAUI 中的典型用法是搭配 SQLite（通过
Microsoft.Data.Sqlite）实现本地数据访问。
✅ 前提：确认运行环境支持 SQLite
MAUI 支持 Android、iOS、Windows、macOS，这些平台均兼容
Microsoft.Data.Sqlite（基于原生 sqlite3 库）。.NET 6+ 已内置该包，无需额外安装 native 依赖（MAUI SDK 已打包）。 确保项目目标框架为
net7.0-android、
net7.0-ios、
net7.0-windows10.0.19041或更高版本 添加 NuGet 包：
Microsoft.Data.Sqlite（推荐 7.x/8.x，与 .NET MAUI 版本对齐） Dapper 本身只需引用
Dapper（最新稳定版即可，如 2.1.24）
✅ 初始化 SQLite 连接并注册为服务
在
MauiProgram.cs中配置 SQLite 连接工厂，避免每次查询都新建连接（SQLite 是文件数据库，适合复用连接）。
// MauiProgram.cs
var builder = MauiApp.CreateBuilder();
builder
.UseMauiApp<App>()
.ConfigureFonts(fonts =>
{
fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
});
<p>// 注册 SQLite 连接（作用域生命周期，推荐）
builder.Services.AddScoped<IDbConnection>(sp =>
{
var dbPath = Path.Combine(FileSystem.AppDataDirectory, "app.db");
var connection = new SqliteConnection($"Data Source={dbPath}");
connection.Open(); // 确保连接就绪（可选，Dapper 会在 Execute 时自动 Open）
return connection;
});</p><p>// 同时注册 Dapper 封装的服务（可选，便于测试和解耦）
builder.Services.AddScoped<IDataAccess, SqliteDataAccess>();
</p>✅ 编写 Dapper 数据访问逻辑（推荐封装）
不建议在 ViewModel 或页面中直接写
connection.Query<t>()</t>，应封装成服务，统一处理连接、事务、异常。
public class SqliteDataAccess : IDataAccess
{
private readonly IDbConnection _connection;
<pre class="brush:php;toolbar:false;">public SqliteDataAccess(IDbConnection connection) => _connection = connection;
public async Task<List<User>> GetAllUsers() =>
(await _connection.QueryAsync<User>("SELECT * FROM Users")).AsList();
public async Task<int> InsertUser(User user) =>
await _connection.ExecuteAsync("INSERT INTO Users (Name, Email) VALUES (@Name, @Email)", user);}
使用QueryAsync/
ExecuteAsync配合
async/await，避免阻塞 UI 线程 参数化查询防止 SQL 注入（Dapper 自动处理） 如需事务，用
using var tx = _connection.BeginTransaction()+
tx.Commit()
✅ 初始化数据库表（首次启动时）
MAUI 应用首次运行需建表。可在 App 启动时检查并迁移（简易版，无 EF Core Migrations）：
public partial class App : Application
{
public App()
{
InitializeComponent();
InitializeDatabase().Wait(); // 或在 SplashScreen 页面异步初始化
MainPage = new AppShell();
}
<pre class="brush:php;toolbar:false;">private async Task InitializeDatabase()
{
var connection = Services.GetService<IDbConnection>();
await connection.ExecuteAsync(@"
CREATE TABLE IF NOT EXISTS Users (
Id INTEGER PRIMARY KEY AUTOINCREMENT,
Name TEXT NOT NULL,
Email TEXT UNIQUE)");
}}
基本上就这些。Dapper 在 MAUI 中不是“集成难题”，而是“定位清晰”——它只负责把对象和 SQL 映射好，底层靠 SQLite 跑，上层靠 MVVM 组织。避开服务端数据库直连误区，用好本地 SQLite + Dapper，轻快又可靠。
