EF Core 9.0.1+ 版本中用户机密文件连接字符串失效问题解析

问题背景

在 EF Core 9.0.1 及以上版本中，开发人员发现了一个影响数据库脚手架操作的重要问题：当使用 dotnet ef dbcontext scaffold 命令时，系统无法正确读取 userconfig.json 文件中配置的连接字符串，而是错误地使用了 appsettings.json 中的无效连接字符串。

问题表现

开发环境配置如下：

• 在 userconfig.json 中配置了有效的数据库连接字符串
• 在 appsettings.json 中故意配置了无效的连接字符串
• 使用 EF Core 9.0.1+ 版本执行脚手架命令

预期行为应该是使用 userconfig.json 中的有效连接字符串，但实际行为却是尝试使用 appsettings.json 中的无效连接字符串，导致连接数据库失败。

技术分析

用户配置文件机制

用户配置文件是 ASP.NET Core 提供的一种存储数据的方式，它不会将信息提交到源代码仓库中。在开发环境中，userconfig.json 文件通常存储在用户特定的目录中，而不是项目目录下。

EF Core 脚手架工作原理

当执行 dotnet ef dbcontext scaffold 命令时，EF Core 设计时工具会：

1. 构建应用程序
2. 初始化配置系统
3. 尝试读取指定的连接字符串
4. 使用该连接字符串连接到数据库并生成模型代码

版本差异

在 EF Core 9.0.0 中，这一机制工作正常，能够正确识别用户配置文件中的连接字符串。但从 9.0.1 版本开始，配置加载逻辑发生了变化，导致无法正确识别用户配置文件中的配置。

临时解决方案

目前有两种可行的临时解决方案：

1. 降级 EF Core 设计时工具： 将 Microsoft.EntityFrameworkCore.Design 包降级到 9.0.0 版本，可以恢复原有的行为。

2. 移动连接字符串： 将连接字符串从 userconfig.json 移动到 appsettings.json 中，但这会降低安全性，不适合生产环境使用。

最佳实践建议

对于需要处理数据库连接字符串的场景，建议：

1. 在开发环境中，可以暂时使用降级方案
2. 考虑使用环境变量来存储连接字符串
3. 对于生产环境，应该使用安全的密钥管理系统
4. 关注 EF Core 的更新，等待官方修复此问题

总结

这个问题的出现提醒我们，即使是成熟的框架也会在版本更新中引入意外的问题。作为开发人员，我们需要：

• 仔细阅读每个版本的更新日志
• 在升级前进行充分的测试
• 了解框架内部机制以便快速定位问题
• 建立完善的配置管理策略

对于依赖 EF Core 进行数据库开发的项目，建议在升级到 9.0.1+ 版本前评估此问题的影响，并制定相应的应对策略。