ASP.NET Core应用本地运行生产环境时Azure数据库连接字符串为空报错

错误根因 #

你遇到的ArgumentNullException是因为Configuration.GetConnectionString("HikingContextProd")返回了null，空值被传入UseSqlServer方法触发了参数校验失败，和连接字符串本身是否正确无关，核心问题是生产环境下程序没有加载到对应配置。

解决方案 #

• 核心原因：ASP.NET Core默认的用户机密（secrets.json）配置源仅在开发环境下会被自动加载，当你切换到Production环境运行时，程序默认不会读取secrets.json中的内容，因此无法获取到HikingContextProd连接字符串。
• 本地临时测试方案：如果仅需要在本地切换生产环境测试连接，可以手动修改配置构建逻辑，强制生产环境也加载用户机密：

// 在Program.cs或Startup.cs的配置构建逻辑中添加以下判断
if (env.IsDevelopment() || env.IsProduction())
{
    // 注意替换为你项目对应的入口类
    builder.AddUserSecrets<Startup>();
}

注意：该配置仅可用于本地测试，绝对不要带到线上Azure部署环境，用户机密是开发阶段的本地配置方案，不具备生产安全性。

• 线上Azure部署正确方案：部署到Azure App Service时，无需使用secrets.json存储生产连接串，直接在Azure门户对应App Service的「配置」-「连接字符串」板块添加名称为HikingContextProd的连接串，Azure会自动将该配置以环境变量的形式注入到程序中，优先级高于本地配置文件，无需修改代码即可正常读取。
• 验证方法：可在ConfigureServices方法开头添加调试代码，断点查看Configuration.GetConnectionString("HikingContextProd")的返回值，也可遍历Configuration.Providers属性查看当前加载的配置源，确认用户机密源是否存在。

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