PAYATHON 2026

ASP.NET Core 10 Web API 项目为何提示连接字符串为空?

排障赵师傅

connString 已经是连接字符串的值,代码却又把它当作配置名称传给了 GetConnectionString()。

将这一行:

builder.Services.AddDbContext<POA_CSMContext>(options =>
    options.UseSqlServer(configuration.GetConnectionString(connString)));

改为:

builder.Services.AddDbContext<POA_CSMContext>(options =>
    options.UseSqlServer(connString));

修改后如果仍然报错,再检查 POA_CSMContext 的构造函数和其他配置逻辑。

为什么配置有值,DbContext 却拿不到?

GetConnectionString() 接收的参数是连接字符串的名称。例如:

var connString =
    configuration.GetConnectionString("DefaultConnection");

读取的是配置项:

ConnectionStrings:DefaultConnection

假设读出的值是:

Server=YOUR_SERVER;Database=YOUR_DATABASE;Integrated Security=True;

接下来再调用:

configuration.GetConnectionString(connString)

就会用整段 Server=...;Database=... 作为名称,到 ConnectionStrings 节点下再次查找。通常没有这样的配置项,所以第二次读取会返回 null,并将它传给 UseSqlServer()。

因此,即使调试时第一次读到的 connString 完全正确,注册 POA_CSMContext 时传入的也已经是另一次查找的结果。

EF Core 通常在执行查询时才打开数据库连接,所以异常会出现在 FindByNameAsync() 中的 FirstOrDefaultAsync(),而不是创建 FSMUserStore 时。

建议使用同一个配置对象

当前代码额外创建了一个 ConfigurationBuilder:

IConfiguration configuration = new ConfigurationBuilder()
    .AddJsonFile("appsettings.json")
    .AddEnvironmentVariables()
    .Build();

这个配置对象与 WebApplication.CreateBuilder(args) 提供的 builder.Configuration 是分别构建的。默认情况下,控制器注入的 IConfiguration 来自应用服务容器,创建局部变量 configuration 不会自动替换它。因此,控制器能读到某个配置值,并不能证明 AddDbContext() 使用了同一个配置对象或同一个值。

可以统一使用 builder.Configuration 读取连接字符串,再注册数据库上下文:

using Microsoft.EntityFrameworkCore;
using PortalDataModels.Models;

var builder = WebApplication.CreateBuilder(args);

IConfiguration configuration = builder.Configuration;

var connString =
    configuration.GetConnectionString("DefaultConnection");

if (string.IsNullOrWhiteSpace(connString))
{
    throw new InvalidOperationException(
        "未配置 ConnectionStrings:DefaultConnection。");
}

builder.Services.AddDbContext<POA_CSMContext>(options =>
    options.UseSqlServer(connString));

// 继续注册 Identity、JWT、控制器等服务。

后续的 JWT、Elmah 等配置也可以继续使用这里的 configuration 和 connString。这样,启动代码和控制器读取的是同一套应用配置,配置缺失时也能尽早报出明确的错误。

对应的 appsettings.json 结构应当是:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=YOUR_SERVER;Database=YOUR_DATABASE;Integrated Security=True;"
  }
}

示例中的服务器、数据库和认证方式需要按实际环境填写。如果通过环境变量配置,对应名称通常写作:

ConnectionStrings__DefaultConnection

检查时还要留意,当前环境的 appsettings.{Environment}.json 和环境变量是否覆盖了预期值。

确认 POA_CSMContext 接收并传递 options

问题中没有提供 POA_CSMContext 的实现,无法判断其中是否还有其他配置问题。需要检查它是否有接收泛型 DbContextOptions 的构造函数,并将参数传给基类:

public POA_CSMContext(
    DbContextOptions<POA_CSMContext> options)
    : base(options)
{
}

将这个构造函数示例合并到现有上下文类中时,应保留已有实体和映射。

AddDbContext() 配置的 SQL Server 提供程序和连接字符串会通过 options 传给上下文。如果构造函数接收了 options,却没有调用 base(options),这些外部配置就无法按预期传给 DbContext。

如果类中还有 OnConfiguring(),也要检查它是否再次调用 UseSqlServer(),覆盖了依赖注入提供的配置。需要保留备用配置时,可以使用以下结构:

protected override void OnConfiguring(
    DbContextOptionsBuilder optionsBuilder)
{
    if (!optionsBuilder.IsConfigured)
    {
        // 仅在没有外部配置时设置备用配置。
    }
}

如果上下文统一通过依赖注入创建,把连接配置集中放在 AddDbContext() 中通常更容易排查。

修改后如何验证?

在 FSMUserStore 构造函数的断点处,可以通过公开 API 检查实际注入的上下文:

ctx.Database.ProviderName
ctx.Database.GetConnectionString()

需要确认:

  • 提供程序是否为预期的 SQL Server 提供程序。
  • GetConnectionString() 是否返回预期配置。
  • 项目中是否还有其他 POA_CSMContext 注册、手动 new POA_CSMContext(),或重新设置连接字符串的代码。

连接字符串可能包含凭据,只在本地调试时检查,不要将完整值输出到接口响应或普通日志中。

连接字符串正确后,如果查询仍出现登录失败、网络连接失败或证书错误,就需要根据新的异常分别排查。

Identity 注册还需要注意什么?

代码同时使用了:

builder.Services.AddScoped<IUserStore<FSMUser>, FSMUserStore>();

和:

.AddEntityFrameworkStores<POA_CSMContext>()

前者提供自定义用户存储,后者注册 EF Core Identity 存储。需要确认最终解析出的 IUserStore<FSMUser> 是否为 FSMUserStore,并核对用户存储和角色存储各自使用的实现。

题目中已经能进入 FSMUserStore 构造函数,说明当前执行路径用到了这个自定义存储。先在 AddDbContext() 中修正连接字符串即可,无需在 FSMUserStore 或 LoginController 中重复设置。

重复的 AddElmah() 和额外的 AddScoped<UserManager<FSMUser>>() 也可以一并清理,让注册代码更清楚。不过,它们无法解释这里的二次 GetConnectionString() 查找错误,也不能据此判断是 .NET 10 的版本问题。

备注:内容仅供参考。