EntityFramework Core 中DbContext连接池初始化问题分析

在EntityFramework Core项目中，开发人员可能会遇到一个棘手的数据库连接问题。当使用DbContext连接池时，某些请求能够正常处理，而另一些请求则会抛出"System.InvalidOperationException: The ConnectionString property has not been initialized"异常。这个问题在Azure WebApp环境中尤为明显，而在本地开发环境中却难以复现。

问题现象

开发人员在使用Aspire框架的AddSqlServerDbContext方法注册DbContext时，发现数据库连接不稳定。部分请求能够成功执行，而部分请求会失败并抛出连接字符串未初始化的异常。日志显示的错误堆栈表明问题发生在尝试打开数据库连接时。

问题根源

经过深入分析，这个问题与EntityFramework Core的DbContext连接池机制有关。当使用AddDbContextPool方法时，EF Core会维护一个DbContext实例池以提高性能。然而在某些情况下，特别是部署在Azure WebApp环境中时，连接池中的DbContext实例可能未能正确初始化其连接字符串属性。

解决方案对比

开发人员尝试了两种不同的DbContext注册方式：

1. 问题方式：使用Aspire提供的便捷方法

builder.AddSqlServerDbContext<MyDbContext>("somedb");

2. 解决方案：手动配置DbContext

var connectionString = builder.Configuration.GetConnectionString("somedb");
ArgumentException.ThrowIfNullOrEmpty(connectionString);

builder.Services.AddDbContext<MyDbContext>(o =>
{
    o.UseSqlServer(connectionString);
});
builder.EnrichSqlServerDbContext<MyDbContext>();

第二种方式通过显式获取和验证连接字符串，确保了DbContext的稳定初始化，从而解决了间歇性连接失败的问题。

技术深入

进一步测试表明，使用AddDbContextPool方法直接替换AddDbContext方法能够复现相同的问题：

builder.Services.AddDbContextPool<MyDbContext>(o =>
{
    o.UseSqlServer(connectionString);
});

这证实了问题确实与EF Core的连接池实现有关。在特定环境下，连接池中的DbContext实例可能在重用前未能正确重置其连接状态。

最佳实践建议

对于生产环境中的EntityFramework Core应用，特别是部署在云服务如Azure上时，建议：

1. 显式获取和验证连接字符串
2. 谨慎使用DbContext连接池，特别是在复杂部署环境中
3. 实施全面的连接字符串验证机制
4. 考虑实现自定义的健康检查来监控DbContext的初始化状态

这个问题提醒我们，在使用高级抽象时仍需关注底层实现细节，特别是在分布式和云环境中，各种边界条件可能导致预期之外的行为。