EFCorePowerTools中存储过程结果类命名的变更与修复

问题背景

在使用EFCorePowerTools工具生成数据库模型和上下文时，用户发现从某个版本开始，存储过程的结果类命名规则发生了变化。具体表现为：

• 旧版本生成的类名：p_GetViewModelResult
• 新版本生成的类名：PGetViewModelResult

这种变化发生在用户没有修改配置文件的情况下，且数据库中的存储过程名称保持为p_GetViewModel不变。

技术分析

命名规则变更的原因

EFCorePowerTools工具在处理数据库对象命名时，会根据配置选项决定如何转换数据库名称到C#类名。主要涉及以下两个配置项：

1. UseDatabaseNames：控制是否使用数据库原始名称
2. UseDatabaseNamesForRoutines：专门控制存储过程和函数的命名方式

在新版本中，工具对命名转换逻辑进行了调整，导致下划线(_)被移除，类名采用了更紧凑的PascalCase命名风格。

影响范围

这一变更主要影响：

1. 存储过程结果类的命名
2. 结果类中属性的命名规则（当UseDatabaseNamesForRoutines设为false时）

解决方案

临时解决方案

用户发现可以通过以下配置组合暂时解决问题：

{
  "UseDatabaseNames": true,
  "UseDatabaseNamesForRoutines": false
}

但这会导致另一个问题：结果类中的属性名也会被转换为PascalCase格式，可能不符合数据库原始命名。

官方修复

项目维护者确认这是一个bug，并在后续版本中进行了修复。修复后的版本将：

1. 恢复原始命名规则，保持与数据库名称一致
2. 确保属性名也保持数据库原始命名

版本兼容性说明

需要注意的是，此问题在EF Core 6中尤为明显，因为EF Core 6已结束官方支持周期。维护者特别为EF Core 6发布了修复补丁，同时也建议用户考虑升级到受支持的EF Core版本。

最佳实践建议

1. 对于需要保持数据库原始命名的项目，建议明确设置：

   {
     "UseDatabaseNames": true,
     "UseDatabaseNamesForRoutines": true
   }
   

2. 定期检查工具更新，特别是当发现命名规则发生变化时

3. 对于长期项目，考虑制定明确的命名规范并记录在项目中，减少因工具更新带来的影响

4. 在升级EF Core版本时，建议先在测试环境中验证生成的代码是否符合预期

总结

EFCorePowerTools作为一款强大的数据库逆向工程工具，其命名规则的细微变化可能会对项目产生较大影响。通过理解其配置选项和工作原理，开发者可以更好地控制代码生成结果，确保与项目规范保持一致。此次命名规则的变更和修复过程也提醒我们，在使用自动化工具时，保持对生成代码质量的关注十分重要。