C# MAUI是微软推出的跨平台应用框架，一套代码可以跑在Windows、Android、iOS和macOS上。不少刚接触MAUI的同学会发现一个尴尬的问题：原来在WinForms或WPF里用得好好的SqlConnection，到了Android和iOS上直接报错，甚至编译都过不去。这篇文章就来把MAUI连接SQL Server这件事讲透，包括为什么会有平台限制、移动端应该怎么设计数据访问架构，以及具体的代码实现。
为什么MAUI移动端不能直接连SQL Server
首先要理解一个底层事实：Microsoft.Data.SqlClient依赖的原生网络和加密组件（比如Windows上的SSPI、NTLM认证相关库）在Android和iOS上并不存在。SqlClient的通信走的是TDS协议（Tabular Data Stream，端口默认1433），这个协议栈的实现绑定了很多Windows特有的东西。MAUI虽然支持多平台，但每个平台的运行时环境差异很大，桌面端有完整的.NET运行时能力，移动端则是精简版运行时加原生平台沙箱。
另一个原因是安全。如果移动App直接内置连接字符串去连SQL Server，意味着数据库的账号密码被硬编码进了APK或IPA包里，用反编译工具轻松就能提取出来。而且公网上直接暴露1433端口给全世界访问，等于把数据库大门敞开，攻击面极大。所以无论从技术可行性还是安全角度，移动端直连数据库都不是正确做法。
业界通用的架构是把数据库访问收敛到服务端，移动端通过HTTP或HTTPS接口与中间服务通信。这也解释了为什么很多MAUI教程里的数据访问部分都在讲HttpClient和REST API，而不是讲ADO.NET。
方案一：通过ASP.NET Core Web API中转（推荐）
这是最标准、最通用的方案。整体链路是：MAUI应用通过HttpClient请求Web API，Web API运行在服务器上，由它访问SQL Server，再把结果以JSON形式返回给客户端。数据库连接字符串只存在于服务端配置里，客户端完全不接触数据库凭据。
先搭建Web API项目，服务端可以放心使用Microsoft.Data.SqlClient或EF Core。下面是服务端的核心代码，包含连接字符串配置和查询接口：
// appsettings.json 中配置连接字符串
// "ConnectionStrings": { "Default": "Server=192.168.1.100;Database=OrderDb;User Id=sa;Password=YourPwd;TrustServerCertificate=True;" }
[ApiController]
[Route("api/[controller]")]
public class ProductController : ControllerBase
{
private readonly string _connStr;
public ProductController(IConfiguration config)
{
_connStr = config.GetConnectionString("Default");
}
[HttpGet]
public async Task<List<Product>> GetAll()
{
var list = new List<Product>();
using var conn = new SqlConnection(_connStr);
await conn.OpenAsync();
var cmd = new SqlCommand("SELECT Id, Name, Price FROM Products", conn);
using var reader = await cmd.ExecuteReaderAsync();
while (await reader.ReadAsync())
{
list.Add(new Product
{
Id = reader.GetInt32(0),
Name = reader.GetString(1),
Price = reader.GetDecimal(2)
});
}
return list;
}
}
MAUI端调用就简单了，只需要HttpClient发起GET请求，反序列化成实体列表。建议把HttpClient封装成服务注册到依赖注入容器，避免频繁创建连接造成套接字耗尽：
public class ApiService
{
private readonly HttpClient _http;
public ApiService()
{
_http = new HttpClient
{
BaseAddress = new Uri("https://your-api-server.com/")
};
}
public async Task<List<Product>> GetProductsAsync()
{
var response = await _http.GetAsync("api/product");
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();
return JsonSerializer.Deserialize<List<Product>>(json,
new JsonSerializerOptions { PropertyNameCaseInsensitive = true });
}
}
// 在MauiProgram.cs中注册
builder.Services.AddSingleton<ApiService>();
注意Android上的坑：如果API地址用的是HTTP而非HTTPS，需要在Android项目的AndroidManifest.xml里配置android:usesCleartextTraffic="true"，否则请求会被系统直接拦截。iOS同样有ATS（App Transport Security）限制，生产环境务必使用HTTPS。另外Android模拟器访问本机服务时，localhost要换成10.0.2.2，这是模拟器的回环地址映射。
方案二：Windows桌面端MAUI直连SQL Server
如果你的MAUI应用只面向Windows桌面，比如企业内部工具，那么直接引用Microsoft.Data.SqlClient是可行的，因为Windows目标平台具备完整的运行时支持。这种方式省去了搭建API的麻烦，适合快速开发内网应用。
public async Task<DataTable> QueryDirectAsync(string sql)
{
var dt = new DataTable();
var connStr = "Server=192.168.1.100;Database=OrderDb;" +
"User Id=sa;Password=YourPwd;TrustServerCertificate=True;";
using var conn = new SqlConnection(connStr);
await conn.OpenAsync();
using var adapter = new SqlDataAdapter(sql, conn);
adapter.Fill(dt);
return dt;
}
但这个方案有明显局限：第一，同一份代码没法编译到Android和iOS目标；第二，连接字符串暴露在客户端，哪怕只是内网应用也存在凭据泄露风险；第三，SQL Server需要保证客户端机器能通过网络到达1433端口，防火墙和VPN都要配置妥当。实践中更常见的折中做法是用条件编译，把直连代码限定在Windows平台：
#if WINDOWS
var dt = await QueryDirectAsync("SELECT * FROM Products");
#else
var list = await apiService.GetProductsAsync();
#endif
方案三：轻量级替代与选型建议
除了自建Web API，还有一些轻量方案值得了解。如果团队熟悉云服务，可以用Azure Mobile Apps或Supabase这类BaaS（后端即服务），它们直接提供REST接口和身份认证，客户端SDK对MAUI支持也不错。如果数据规模小且以离线为主，可以干脆放弃远程SQL Server，改用本地SQLite，同步时再走API，这正是微软官方MAUI示例中常见的做法。
三种主流方案对比如下：
| 方案 | 平台支持 | 安全性 | 开发成本 | 适用场景 |
|---|---|---|---|---|
| Web API中转 | 全平台 | 高 | 中 | 大多数生产项目 |
| Windows直连 | 仅Windows | 低 | 低 | 内网企业工具 |
| BaaS服务 | 全平台 | 中高 | 低 | 小型应用、快速原型 |
综合来看，除非确定只发布Windows版本，否则一开始就应该按Web API架构来设计。这样做还有个隐性好处：以后Web、小程序等其他前端也能复用同一套接口，数据库结构变更时只需要改服务端，不用强制所有客户端升级。数据访问层与界面分离，是跨平台项目里最值得坚持的原则之一。
C# MAUISQL Server远程数据库访问修改时间：2026-09-03 12:24:57