从Kentico 12 MVC升级至Kentico 13的可行路径与问题咨询

1. 升级过程中可能丢失的不再受支持功能及规避方案 #

以下是Kentico 13不再支持的核心功能及对应解决方法：

• 旧版MVC视图模型绑定逻辑：Kentico 12中直接继承PageViewModel<T>的部分构造函数在13中被移除，无法直接通过旧方式传递页面数据。
  规避：重构视图模型，使用PageDataContext.GetPage<T>()在视图中获取页面数据，或改用Kentico 13提供的新PageViewModel构造器，配合依赖注入传递必要的上下文参数。
• Web Forms兼容层及控件：Kentico 13完全移除了Web Forms相关支持，原有项目中遗留的Web Forms用户控件、HTTP模块无法正常运行。
  规避：将Web Forms控件重写为MVC视图组件或Tag Helper；HTTP模块替换为ASP.NET Core中间件（若后续升级.NET Core），或改用Kentico 13内置的MVC扩展功能。
• 过时权限检查API：PermissionChecker类的静态方法被标记为过时，Kentico 13统一使用IPermissionService接口。
  规避：在控制器、视图组件中依赖注入IPermissionService，替换所有权限检查代码为该接口的CheckPermissionAsync等方法。
• 旧版媒体库操作API：MediaLibraryInfoProvider的部分静态方法不再推荐使用，Kentico 13优先提供IMediaFileService接口。
  规避：重构媒体文件增删改查逻辑，通过依赖注入IMediaFileService来处理媒体库操作，替代旧的静态方法调用。
• 自定义模块旧注册方式：Kentico 12中在Module类OnInit方法中注册服务的逻辑，在13中被ConfigureServices方法替代。
  规避：修改自定义模块代码，重写Module.ConfigureServices方法，通过IServiceCollection注入模块所需的服务，遵循依赖注入设计原则。

2. 升级至Kentico 13 MVC（.NET Framework）与.NET Core版本的差异及直接升级风险 #

核心差异 #

Kentico 13分为两个分支：基于.NET Framework的Kentico 13 MVC，和基于.NET Core的Kentico Xperience 13 .NET Core，差异主要在以下几点：

• 运行环境：.NET Framework版仅支持IIS；.NET Core版支持跨平台部署，使用Kestrel服务器，适配现代云原生部署场景。
• API与架构设计：.NET Core版完全遵循ASP.NET Core的设计规范，比如依赖注入深度整合、使用IConfiguration替代传统AppSettings、中间件管道替代HTTP模块；.NET Framework版则延续ASP.NET MVC 5的架构。
• 路由与视图系统：.NET Core版使用ASP.NET Core路由系统，路由模板语法、约束逻辑与.NET Framework版的MVC路由有差异；视图层更多使用Tag Helper替代HTML Helper，且视图组件的实现方式不同。

直接升级至.NET Core版本的风险 #

直接从Kentico 12 MVC（.NET Framework）升级到Kentico Xperience 13 .NET Core会面临较多问题：

• 代码重构量巨大：.NET Framework与.NET Core的API差异显著，比如HttpContext操作、Session管理、依赖注入方式完全不同，原有控制器、视图、自定义组件几乎都需要适配重写。
• 第三方库兼容问题：原有项目依赖的.NET Framework专属库可能没有.NET Core版本，需要寻找替代方案或自行移植。
• 学习曲线陡峭：开发团队需要快速掌握ASP.NET Core的开发模式，包括中间件、Startup配置、配置系统等，同时熟悉Kentico Xperience 13 .NET Core的特有API。
• 迁移工具局限性：Kentico官方迁移工具主要针对.NET Framework版的升级，.NET Core版的迁移需要大量手动调整，没有完整的自动化工具支持。

如果团队缺乏.NET Core经验，建议先升级到Kentico 13 MVC（.NET Framework），待业务稳定后再逐步迁移到.NET Core；若团队有.NET Core技术储备且项目复杂度较低，可尝试直接升级，但需提前做好代码重构计划和充分测试。

3. 业内升级实践经验 #

• 分阶段迭代升级：不要一次性完成所有升级工作，优先完成核心Kentico组件的升级，确保后台管理、页面渲染等基础功能正常，再逐步处理过时API替换、自定义模块重构、业务逻辑适配。
• 全量测试覆盖：搭建与生产环境一致的测试环境，复制生产数据进行升级测试，覆盖页面编辑、媒体库操作、用户权限、自定义功能等所有核心场景，重点验证数据完整性（如页面字段、用户数据、媒体文件是否正常迁移）。
• 升级前代码审计：提前对现有项目进行代码扫描，标记所有使用过时API、Web Forms兼容代码、第三方依赖的位置，制定针对性的重构方案，避免升级过程中出现突发问题。
• 清理冗余依赖：升级前移除项目中无用的NuGet包、第三方库、废弃代码，减少升级过程中的兼容性冲突，降低重构难度。
• 严格遵循官方指南：按照Kentico官方的升级文档逐步操作，重点关注版本间的API变更列表、配置文件调整说明，官方提供的升级工具可自动处理核心配置和数据迁移，但自定义代码需手动调整。
• 提前技术储备：若计划升级到.NET Core版本，提前组织团队学习ASP.NET Core和Kentico Xperience 13 .NET Core的开发模式，通过小型Demo项目熟悉新的API和架构，减少正式升级时的踩坑概率。

内容的提问来源于stack exchange，提问作者tone