如何在ASP.NET Core中配置本地机密及多环境数据库连接字符串

本地机密（User Secrets）是ASP.NET Core专门为本地开发设计的敏感配置存储机制，它的文件不会被纳入源码控制，非常适合存放密码、密钥这类不想公开的信息。操作起来很简单：

• 第一步：初始化用户机密。打开项目所在的终端，运行命令：

  dotnet user-secrets init
  

  这个命令会在你的项目文件（比如.csproj）中添加一个UserSecretsId元素，用来关联本地的机密文件。

• 第二步：添加机密内容。比如你要存一个数据库密码，就运行：

  dotnet user-secrets set "DbSettings:Password" "your-local-db-password"
  

  你也可以直接找到本地机密文件手动编辑，文件的默认位置：

  • Windows：%APPDATA%\Microsoft\UserSecrets\<项目的UserSecretsId>\secrets.json
  • macOS/Linux：~/.microsoft/usersecrets/<项目的UserSecretsId>/secrets.json

• 第三步：在代码中读取机密。通过依赖注入的IConfiguration对象就能轻松获取，比如在控制器里：

  private readonly IConfiguration _configuration;
  
  public HomeController(IConfiguration configuration)
  {
      _configuration = configuration;
  }
  
  public IActionResult Index()
  {
      var dbPassword = _configuration["DbSettings:Password"];
      // 用密码做后续操作
      return View();
  }
  

要注意，用户机密只适合本地开发环境使用，生产环境建议改用Azure Key Vault或环境变量这类更安全的配置方案。

这个需求刚好可以通过用户机密来完美解决，完全不用改动源码仓库里的appsettings.json或appsettings.Development.json，具体步骤如下：

• 第一步：给本地添加专属的连接字符串机密。运行命令：

  dotnet user-secrets set "ConnectionStrings:MyDatabase" "Server=localhost;Database=MyLocalDb;Trusted_Connection=True;"
  

  这里的MyDatabase要和你源码文件里配置的连接字符串名称保持一致，比如源码中appsettings.Development.json的内容可能是：

  {
    "ConnectionStrings": {
      "MyDatabase": "Server=shared-dev-sql;Database=SharedDevDb;Trusted_Connection=True;"
    }
  }
  

• 第二步：在代码中正常读取连接字符串。使用IConfiguration的GetConnectionString方法即可：

  var connectionString = _configuration.GetConnectionString("MyDatabase");
  

ASP.NET Core的配置读取优先级是：用户机密 > 环境变量 > 环境专属appsettings（如appsettings.Development.json） > 全局appsettings.json。所以本地运行时，程序会优先读取你存在用户机密里的本地连接字符串，源码仓库里的共享开发配置不会被修改；部署到Azure的staging或prod环境时，你可以通过Azure门户的“应用服务配置”（或环境变量）设置对应环境的连接字符串，这些配置会自动覆盖源码里的默认值，全程不需要改动代码或仓库里的配置文件。

这样就完美实现了“本地用专属连接串、各环境用各自配置、不修改源码文件”的需求。

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