<think>我们正在讨论在IIS上部署
.NET Core应用时解决
Microsoft.Data
.SqlClient的问题。根据之前的对话，我们知道
Microsoft.Data
.SqlClient是推荐用于
.NET Core及更高
版本的SQL Server数据提供程序，它支持跨平台和现代功能。然而，在IIS环境下部署时可能会遇到一些问题，比如依赖项、配置和安全等问题。
主要问题可能包括：
1
. 缺少SNI
.dll（用于网络通信的本地库）
导致运行时错误。
2
. 连接字符串配置问题，特别是当使用Azure AD身份验证时。
3
. 权限问题，因为IIS应用程序池账户可能需要访问SQL Server。
4
. 部署时未正确包含
Microsoft.Data
.SqlClient的依赖项。
我们将逐步解决这些问题。
### 步骤1: 确保项目正确引用
Microsoft.Data
.SqlClient
在项目中，确保已通过NuGet安装了`
Microsoft.Data
.SqlClient`包。检查项目文件（
.csproj）中是否有如下引用：
```xml
<ItemGroup>
<PackageReference Include="
Microsoft.Data
.SqlClient" Version="latest" />
</ItemGroup>
```
### 步骤2: 处理SNI
.dll依赖
`
Microsoft.Data
.SqlClient`依赖于一个名为SNI
.dll的本地库。在部署时，必须确保该库被正确复制到输出目录。根据目标平台（x86、x64、ARM等），NuGet包会自动将对应的SNI
.dll复制到输出目录的`
runtimes`子目录下。在IIS中，应用程序池的位数（32位或64位）必须与部署的应用程序的位数匹配，否则将无法加载SNI
.dll。
在IIS中设置应用程序池：
- 打开IIS管理器，选择应用程序池。
- 找到你的应用程序池，右键选择“高级设置”。
- 设置“启用32位应用程序”为True或False，以匹配你的应用程序的位数。通常，对于64位系统，应设置为False（即使用64位模式），除非你的应用程序是32位的。
另外，确保在发布应用程序时包含
运行时特定资产。可以使用以下命令发布：
```bash
dotnet publish -c Release -r win-x64 --self-contained false
```
这里`win-x64`表示目标
运行时为Windows 64位。`--self-contained false`表示使用共享的
.NET
运行时，这样部署包会更小。
发布后，检查输出目录中是否有`
runtimes`文件夹，里面应包含`win-x64`（或你指定的
运行时）子文件夹，其中包含`native`目录下的SNI
.dll。
### 步骤3: 配置连接字符串
在IIS环境中，连接字符串通常存储在`
appsettings
.json`或环境变量中，但更安全的做法是使用IIS应用程序池的应用程序设置（在IIS管理器中的“配置编辑器”里）或使用Windows身份验证集成。
如果使用Azure AD身份验证，连接字符串可能如下：
```
"ConnectionStrings": {
"DefaultConnection": "Server=tcp:<server-name>
.database
.windows
.net,1433;Initial Catalog=<db-name>;Persist Security Info=False;User ID=<user>;Password=<password>;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Authentication=Active Directory Password;"
}
```
注意：`Authentication`属性是`
Microsoft.Data
.SqlClient`特有的，用于指定Azure AD认证方式。
另外，确保应用程序池的托管账户有权限访问数据库。如果使用集成身份验证（Windows身份验证），则连接字符串中可以使用`Integrated Security=true`，并且需要将应用程序池的托管账户设置为有数据库访问权限的域账户，或者在SQL Server中为该账户创建登录名。
### 步骤4: 处理权限问题
如果应用程序使用集成Windows身份验证连接到SQL Server，则需要：
1
. 在IIS中，为网站启用Windows身份验证（并禁用匿名身份验证）。
2
. 设置应用程序池的标识为具有SQL Server访问权限的域账户（或使用内置账户，如NetworkService，但需要在SQL Server中为该账户授权）。
如果使用SQL Server身份验证（用户名和密码），则确保连接字符串中的用户名和密码正确，并且该账户在SQL Server中有权限。
### 步骤5: 部署到IIS
1
. 在IIS中创建网站，指向发布输出目录。
2
. 确保已安装
.NET Core Hosting Bundle（这是IIS托管
.NET Core应用的必备组件）。可以从[这里](https://dotnet
.microsoft.com/permalink/dot
netcore-current-windows-
runtime-bundle-installer)下载。
3
. 重启IIS：在命令行
运行`iisreset`或重启服务器。
### 常见错误及解决
1
. **SNI
.dll未找到**：确保发布时包含了
运行时特定资产，并且应用程序池的位数设置正确。
2
. **登录
失败**：检查连接字符串和身份验证方式，确保SQL Server允许来自IIS服务器的连接，并且账户有权限。
3
. **加密连接问题**：如果使用加密连接（如Azure SQL），可能需要安装相应的证书或信任根证书。可以尝试在连接字符串中加入`TrustServerCertificate=true`（仅
测试环境使用）或确保服务器证书被客户端信任。
### 示例：在
.NET Core应用中使用
Microsoft.Data
.SqlClient
以下是一个简单的代码示例，展示如何在
.NET Core应用中使用
Microsoft.Data
.SqlClient连接数据库：
```csharp
using
Microsoft.Data
.SqlClient;
using System;
public class DatabaseService
{
private readonly string _connectionString;
public DatabaseService(string connectionString)
{
_connectionString = connectionString;
}
public void QueryDatabase()
{
using (var connection = new SqlConnection(_connectionString))
{
connection
.Open();
var command = new SqlCommand("SELECT TOP 10 * FROM Customers", connection);
using (var reader = command
.ExecuteReader())
{
while (reader
.Read())
{
Console
.WriteLine(reader["CompanyName"]);
}
}
}
}
}
```
### 总结
在IIS上部署使用
Microsoft.Data
.SqlClient的
.NET Core应用时，主要注意以下几点：
- 正确引用NuGet包。
- 确保发布包含
运行时特定的本地库（如SNI
.dll）。
- 配置正确的应用程序池位数。
- 使用合适的连接字符串和身份验证方式。
- 确保应用程序池账户有数据库访问权限。
通过以上步骤，可以解决大多数部署问题。
§§相关问题§§
1
. 如何在IIS中设置应用程序池以
运行.NET Core应用？
2
. 使用
Microsoft.Data
.SqlClient连接Azure SQL数据库时，如何配置Azure AD身份验证？
3
. 在部署
.NET Core应用到IIS时，如何解决“无法加载DLL 'SNI
.dll'”的错误？
4
. 如何为IIS应用程序池账户授予SQL Server访问权限？
5
. 在
.NET Core应用中，如何安全地存储数据库连接字符串？</think>### 在 IIS 上部署
.NET Core 应用时解决
Microsoft.Data
.SqlClient 问题
#### 1
. **SNI
.dll 依赖管理** [^1][^3]
**问题现象**：
部署后出现 `DllNotFoundException: Unable to load DLL 'SNI
.dll'` 错误，这是
Microsoft.Data
.SqlClient 的本地库依赖。
**解决方案**：
```bash
# 发布时包含
运行时特定资产
dotnet publish -c Release -r win-x64 --self-contained false
```
1
. **检查发布目录结构**：
确保 `
runtimes/win-x64/native/` 目录下存在 SNI
.dll 文件
 [^3]
2
. **IIS 应用程序池配置**：
- 32 位应用：启用 `启用32位应用程序` → True
- 64 位应用：设置为 False
- 匹配应用程序池与发布目标平台（x86/x64）
3
. **部署验证**：
使用 `Process Monitor` 工具监控 DLL 加载路径，确保 IIS 工作进程能访问 SNI
.dll
#### 2
. **Azure AD 身份验证配置** [^2][^4]
**连接字符串示例**：
```json
{
"ConnectionStrings": {
"AzureSQL": "Server=tcp:<server>
.database
.windows
.net;Authentication=Active Directory Default;Database=<db>;Encrypt=true;TrustServerCertificate=false"
}
}
```
**配置步骤**：
1
. 在 Azure 门户中为应用注册分配 **托管身份**
2
. 在 SQL Server 中创建包含托管身份的 Azure AD 组：
```sql
CREATE USER [your-
app-name] FROM EXTERNAL PROVIDER;
ALTER ROLE db_datareader ADD MEMBER [your-
app-name];
```
3
. 在 IIS 应用池设置中启用 **托管身份继承**：
```xml
<!--
applicationHost
.config -->
<
applicationPool>
<name>Your
AppPool</name>
<identity type="
ApplicationPoolIdentity" />
</
applicationPool>
```
#### 3
. **连接池优化（高并发场景）** [^4]
**问题现象**：
连接耗尽错误 `Timeout expired
. The timeout period elapsed
...`
**优化方案**：
```csharp
// Program
.cs 中配置连接池
builder
.Services
.AddDbContext<
AppDbContext>(options =>
options
.UseSqlServer(
Configuration
.GetConnectionString("Default"),
sqlOptions =>
{
sqlOptions
.EnableRetryOnFailure(5); // 重试机制
sqlOptions
.MinPoolSize = 10; // 最小连接数
sqlOptions
.MaxPoolSize = 100; // 最大连接数
}
)
);
```
**IIS 配套优化**：
1
. 应用池 → 高级设置：
- **最大工作进程数**：根据 CPU 核数设置（建议 1:1）
- **闲置超时**：0（禁用回收）
2
. 在 `web
.config` 中添加 HTTP 流水线：
```xml
<system
.webServer>
<
applicationInitialization do
AppInitAfterRestart="true">
<add initializationPage="/" />
</
applicationInitialization>
</system
.webServer>
```
#### 4
. **加密连接问题排查** [^3][^4]
**错误场景**：
`
Microsoft.Data
.SqlClient
.SqlException (0x80131904): A connection was successfully established with the server, but then an error occurred during the login process`
**解决步骤**：
1
. 安装最新的 [SQL Server TLS 证书](https://learn
.microsoft.com/zh-cn/sql/database-engine/configure-windows/configure-sql-server-encryption?view=sql-server-ver16)
2
. 在连接字符串添加加密协议：
```
Encrypt=true;TrustServerCertificate=false;HostNameInCertificate=*
.database
.windows
.net
```
3
. 服务器防火墙开放 1433 端口（SQL Server 默认端口）
#### 5
. **部署验证清单**
| 检查项 | 通过标准 | 验证方法 |
|--------|----------|----------|
| SNI
.dll 位置 | 存在于 `
runtimes/win-x64/native/` | 文件系统检查 |
| 平台
一致性 | IIS 应用池位数 = 发布目标平台 | IIS 管理器 → 高级设置 |
| Azure AD 权限 | 托管身份有 db_reader/db_writer 角色 | Azure 门户 → SQL Server |
| 连接池设置 | MinPoolSize ≥ 5, MaxPoolSize ≤ 200 | 应用启动日志 |
| TLS 1
.2 支持 | 服务器注册表启用 TLS 1
.2 | `regedit` → `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols` |
> **关键建议**：始终使用最新稳定版
Microsoft.Data
.SqlClient（通过 NuGet 更新），旧
版本存在已知的部署问题[^4]。
---
### 总结流程
```mermaid
graph TD
A[创建发布包] --> B{包含 SNI
.dll 吗？}
B -->|是| C[配置IIS应用池]
B -->|否| D[添加
运行时标识]
C --> E[设置Azure AD认证]
E --> F[配置连接池参数]
F --> G[启用TLS加密]
G --> H[压力
测试验证]
```
本文介绍了一种常见的.NET Core应用程序部署问题：当本地开发环境与服务器环境的.NET Core版本不一致时，如何解决版本冲突的问题。文章详细描述了异常现象，并提供了解决方案——即在服务器上安装指定版本的.NET Core。
扫一扫
931
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
