.NET Framework 4.8中Membership Provider如何通过User Secret读取连接字符串？

我之前碰到过一模一样的场景，问题的核心在于Membership Provider在ASP.NET应用启动的极早期就会完成初始化，这时候User Secrets配置构建器还没来得及替换web.config里的空连接字符串，导致Membership Provider拿到的是无效的空值，进而触发报错。下面是几个经过验证的解决办法：

一、先确认User Secrets基础配置的正确性 #

先排查最基础的配置问题，确保User Secrets本身能正常工作：

• 检查NuGet包：确认你安装的Microsoft.Configuration.ConfigurationBuilders.UserSecrets是适配.NET Framework 4.8的版本（2.0.0版本是没问题的）
• 核对userSecretsId：右键项目→管理用户机密，查看地址栏里的ID，和web.config里的userSecretsId完全一致
• 验证secrets.xml：确保里面的name属性和web.config中连接字符串的名称完全匹配（你的LocalSqlServer是正确的）

二、自定义Membership Provider延迟读取连接字符串 #

最可靠的方案是自定义一个继承自SqlMembershipProvider的类，在初始化阶段手动从ConfigurationManager获取已经被User Secrets填充后的连接字符串，避开早期加载的空值问题：

1. 创建自定义Membership Provider类 #

在项目中添加如下类文件：

using System.Configuration;
using System.Web.Security;

namespace YourProjectNamespace // 替换成你的项目命名空间
{
    public class CustomSqlMembershipProvider : SqlMembershipProvider
    {
        public override void Initialize(string name, System.Collections.Specialized.NameValueCollection config)
        {
            // 从配置管理器获取User Secrets填充完成后的连接字符串
            var populatedConnectionString = ConfigurationManager.ConnectionStrings["LocalSqlServer"].ConnectionString;
            // 手动覆盖配置中的connectionString参数
            config["connectionString"] = populatedConnectionString;
            
            // 调用基类的初始化逻辑
            base.Initialize(name, config);
        }
    }
}

2. 修改web.config中的Membership配置 #

把原来的type属性替换成你自定义类的完整命名空间和程序集名称：

<membership userIsOnlineTimeWindow="120">
  <providers>
    <remove name="AspNetSqlMembershipProvider" />
    <add name="AspNetSqlMembershipProvider" 
         type="YourProjectNamespace.CustomSqlMembershipProvider, YourProjectAssembly" <!-- 替换成你的命名空间和程序集 -->
         connectionStringName="LocalSqlServer" 
         enablePasswordRetrieval="true" 
         enablePasswordReset="false" 
         requiresQuestionAndAnswer="false" 
         applicationName="/" 
         requiresUniqueEmail="false" 
         passwordFormat="Encrypted" 
         maxInvalidPasswordAttempts="25" 
         minRequiredPasswordLength="4" 
         minRequiredNonalphanumericCharacters="0" 
         passwordAttemptWindow="10" 
         passwordStrengthRegularExpression="" />
    <add name="MyMembershipProvider" 
         type="YourProjectNamespace.CustomSqlMembershipProvider, YourProjectAssembly" <!-- 同样替换 -->
         connectionStringName="LocalSqlServer" 
         enablePasswordRetrieval="true" 
         enablePasswordReset="false" 
         requiresQuestionAndAnswer="false" 
         applicationName="/" 
         requiresUniqueEmail="false" 
         passwordFormat="Encrypted" 
         maxInvalidPasswordAttempts="25" 
         minRequiredPasswordLength="4" 
         minRequiredNonalphanumericCharacters="0" 
         passwordAttemptWindow="10" 
         passwordStrengthRegularExpression="" />
  </providers>
</membership>

三、验证User Secrets是否正常加载 #

在Global.asax的Application_Start方法中添加测试代码，确认User Secrets已经成功填充连接字符串：

protected void Application_Start()
{
    // 测试输出连接字符串，确认是否从User Secrets获取到值
    var connString = ConfigurationManager.ConnectionStrings["LocalSqlServer"].ConnectionString;
    System.Diagnostics.Debug.WriteLine("Loaded Connection String: " + connString);
    
    // 其他初始化代码...
    AreaRegistration.RegisterAllAreas();
    RouteConfig.RegisterRoutes(RouteTable.Routes);
}

启动项目后查看输出窗口，如果能看到正确的连接字符串，说明User Secrets配置是生效的，剩下的就是让Membership Provider正确读取这个值。

额外提示 #

• 确保web.config中configBuilders的配置放在configSections的最顶部，保证配置构建器最先被加载：

<configSections>
  <section name="configBuilders" type="System.Configuration.ConfigurationBuildersSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" restartOnExternalChanges="false" requirePermission="false" />
  <!-- 其他section配置... -->
</configSections>

• 对于EDMX的HIPAADbEntities连接字符串，只需要在secrets.xml中添加对应的secret即可，Entity Framework会在稍后的生命周期中读取到填充后的值，不会有类似Membership的早期加载问题。

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