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 的版本问题。
备注:内容仅供参考。
