近日，.NET 开发者社区中出现了一个备受关注的技术问题：在使用 Entity Framework Core（EF Core）工具进行数据库迁移时，若项目包含多个数据库上下文（DbContext），工具会“忘记”用户指定的迁移文件夹路径，导致迁移文件混乱或生成失败。这一问题在 GitHub 上的相关议题引发热议，不少开发者呼吁微软官方尽快修复该行为。
问题重现：多上下文下的“文件夹盲区”
据开发者反馈，当项目中存在两个或更多继承自 DbContext 的类时，使用 dotnet ef migrations add 命令时，即使通过 --output-dir 参数明确指定了迁移文件夹（例如 Migrations/ContextA），EF Core 工具仍可能将新生成的迁移文件放置到默认的 Migrations 根目录下，而非用户指定的子目录。
更令人困惑的是，在后续执行 dotnet ef migrations remove 或 dotnet ef database update 时，工具会尝试从默认路径寻找迁移文件，导致“找不到迁移”的错误。这一现象被部分开发者戏称为“工具的记忆障碍”——它似乎无法持续跟踪每个上下文对应的迁移文件夹。
背后原因：工具参数传递与上下文解析的脱节
深入分析技术实现后，社区开发者指出，问题根源在于 EF Core 命令行工具（dotnet-ef）在处理多个 DbContext 时，对上下文选择与输出路径参数的绑定逻辑存在缺陷。当项目中有多个 DbContext 时，工具会要求用户通过 --context 参数指定目标上下文。然而，--output-dir 参数值并未与上下文标识符进行持久化关联——工具会将其视为一次性参数，并在后续操作（如移除或更新）中默认重置为 Migrations 根目录。
另一个潜在因素与迁移快照（Snapshot）文件的管理有关。每个 DbContext 都有一个对应的 [DbContextName]ModelSnapshot.cs 文件，默认与迁移文件放在同一目录。当用户手动将迁移文件夹设为子目录后，工具在解析模型差异时可能无法正确定位快照文件，从而引发“上下文状态不一致”警告。
实际影响：从开发效率到生产风险
这一问题对使用多数据库场景的企业级项目影响尤为明显。例如，在微服务架构中，不同数据库上下文可能对应不同的业务模块（如用户上下文、订单上下文），开发者习惯将每个上下文的迁移文件隔离到独立文件夹以便维护。工具的“失忆”行为会导致：
- 文件冲突：多个上下文的迁移文件意外写入同一文件夹，命名前缀（如
20250320_xxx_initial.cs）极易重复，引发编译错误。 - 手动修复成本：开发者需频繁执行
dotnet ef migrations remove --force并重新指定--output-dir，在 CI/CD 流水线中导致构建失败。 - 升级风险：当项目从单上下文重构为多上下文时，现有迁移文件路径变更可能被工具忽略，导致生产环境迁移回滚出错。
社区动态：临时变通方案与官方回应
面对这一问题，社区开发者已提出多种临时变通方法：
- 显式指定完整路径：每次执行迁移命令时，强制使用
--output-dir Migrations/ContextA及--context ContextA，并确认当前目录为项目根。 - 使用自定义设计时工厂：实现
IDesignTimeDbContextFactory<TContext>接口，手动控制上下文实例化与迁移目录逻辑。 - 符号链接绕行：在默认
Migrations目录下为每个上下文创建符号链接，将实际文件重定向至子目录，但此方法被认为“过于 hack”。
微软官方开发团队在 GitHub Issue #27813 中回应，已将该问题标记为“待优先修复”，且计划在 .NET 9 的 EF Core 更新中引入改进。目前，建议开发者升级至 EF Core 8.0.4 或更高版本，该版本部分缓解了多上下文迁移的稳定性问题，但并未完全解决“文件夹失忆”的根因。
结语：工具便利性仍需与复杂场景平衡
Entity Framework Core 作为 .NET 生态中最主流的 ORM 框架，其命令行工具的设计始终追求“约定优于配置”。然而，当现实项目跨越简单演示的边界，进入多上下文、多数据库的复杂场景时，工具对用户显式配置的“遗忘”便成了一处令人头疼的痛点。或许，在这次社区反馈与官方跟进的双重推动下，未来的 EF Core 版本将引入更智能的路径存储机制——例如在项目文件或用户配置中持久化每个上下文对应的迁移文件夹映射。在此之前，开发者们只能继续与这个“健忘”的工具斗智斗勇。