.NET Core 3.1 VB项目发布后无法更新SQL连接字符串求助

问题背景 #

我使用.NET Core 3.1的Visual Basic项目，发布至IIS托管的网站文件夹中。近期将SQL数据库迁移至新服务器后，无法更新连接字符串以连接新服务器：

• 修改了appsettings.json及各环境（开发/生产/发布）版本的配置文件，无效
• 通过Visual Studio的连接服务修改连接字符串，发布后依旧使用旧值
• 手动修改发布时生成的web.config添加连接字符串，无效果
• 发现连接字符串保存在环境变量中，修改后回收应用程序池、重启Web应用，问题仍未解决

排查与解决步骤 #

1. 确认.NET Core配置优先级 #

.NET Core配置读取有明确的优先级顺序（高优先级覆盖低优先级），环境变量之后可能还有更高优先级的配置来源：

• 命令行参数：检查发布脚本或IIS启动参数中是否传递了连接字符串（如--ConnectionStrings:YourConnName=old-server-string），如果有需删除或修改
• 机密管理器（Secret Manager）：若开发环境使用了机密管理器，确认发布时未将机密文件一同部署到服务器
• Azure Key Vault/其他密钥管理服务：如果项目配置了从密钥管理服务读取配置，需同步更新对应服务中的连接字符串

2. 检查IIS站点级配置 #

• 打开IIS管理器，定位到目标站点，进入配置编辑器：
  • 选择配置节为system.webServer/aspNetCore
  • 查看environmentVariables节点，确认是否存在连接字符串相关的环境变量（这里的设置会覆盖系统级环境变量），若有旧值直接修改并应用
• 检查应用程序池的高级设置，确保.NET CLR版本设置为无托管代码（.NET Core为自托管模式，避免与传统.NET配置冲突）

3. 验证应用实际读取的配置 #

在项目中添加一段调试代码，输出应用实际加载的连接字符串及配置来源，快速定位问题：

Imports Microsoft.Extensions.Configuration
Imports Microsoft.AspNetCore.Mvc

Public Class ConfigDebugController
    Inherits ControllerBase

    Private ReadOnly _configuration As IConfiguration

    Public Sub New(configuration As IConfiguration)
        _configuration = configuration
    End Sub

    <HttpGet("debug/connection-strings")>
    Public Function GetConnectionStrings() As ActionResult
        ' 获取所有连接字符串
        Dim connStrings = _configuration.GetSection("ConnectionStrings")
                                        .GetChildren()
                                        .ToDictionary(Function(c) c.Key, Function(c) c.Value)
        
        ' 获取所有配置提供者（用于定位配置来源）
        Dim providers = _configuration.Providers.Select(Function(p) p.ToString())

        Return Ok(New With {
            .ActiveConnectionStrings = connStrings,
            .ConfigurationProviders = providers
        })
    End Function

发布后访问该接口，即可看到应用实际读取的连接字符串及配置来源，确认哪个配置在生效。

4. 检查发布目录文件完整性 #

• 确认发布目录下的appsettings.json、appsettings.Production.json等配置文件是最新修改后的版本，避免增量发布时未覆盖旧文件
• 查看web.config中的<aspNetCore>节点，确认arguments属性未包含旧的连接字符串参数

5. 彻底清理缓存与重启 #

• 执行iisreset命令重启整个IIS服务，确保所有缓存的配置被清除
• 检查服务器上的.NET Core 3.1运行时是否为最新补丁版本，部分旧版本可能存在配置读取的兼容性问题

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