XAF WinForms部署View Variants模块出现IModelViewVariants类型转换异常

在XAF WinForms 21.2.7项目中安装View Variants模块后，本地开发环境运行正常，部署后启动应用触发异常，eXpressAppFramework.log中记录的报错信息如下：

Type:       InvalidCastException
Message:    Unable to cast object of type 'ModelDetailView' to type 'DevExpress.ExpressApp.ViewVariantsModule.IModelViewVariants'.
Data:       0 entries
Stack trace:
at DevExpress.ExpressApp.ViewVariantsModule.ModelVariantsProvider.GetVariants(String rootVariantViewId)
at DevExpress.ExpressApp.ViewVariantsModule.ReplaceViewIdHelper.factoryEvents_ViewCreating(Object sender, ViewCreatingEventArgs e)
at DevExpress.ExpressApp.ViewVariantsModule.XafApplicationViewsFactory.application_ViewCreating(Object sender, ViewCreatingEventArgs e)
at DevExpress.ExpressApp.XafApplication.OnViewCreating(ViewCreatingEventArgs args)
at DevExpress.ExpressApp.XafApplication.PrepareDetailViewCreatingEventArgs(IObjectSpace objectSpace, String detailViewID, Boolean isRoot, Object obj, Boolean isDelayedObjectLoading)
at DevExpress.ExpressApp.XafApplication.CreateDetailViewCore(IObjectSpace objectSpace, String detailViewID, Boolean isRoot, Object obj, Type objectType, Object objectKey, Boolean isDelayedObjectLoading, IEnumerable objectsToPrefetch)
at DevExpress.ExpressApp.XafApplication.CreateDetailView(IObjectSpace objectSpace, String detailViewID, Boolean isRoot, Object obj, Boolean isDelayedObjectLoading, IEnumerable objectsToPrefetch)
at DevExpress.ExpressApp.XafApplication.CreateDetailView(IObjectSpace objectSpace, String detailViewID, Boolean isRoot, Object obj)
at DevExpress.ExpressApp.XafApplication.CreateDetailView(IObjectSpace objectSpace, Object obj, View sourceView)
at DevExpress.ExpressApp.XafApplication.showLogonAction_OnCustomizePopupWindowParams(Object sender, CustomizePopupWindowParamsEventArgs args)
at DevExpress.ExpressApp.Actions.PopupWindowShowAction.GetPopupWindowParams()
at DevExpress.ExpressApp.Win.PopupWindowShowActionHelper.CreatePopupWindow(Boolean createAllControllers)
at DevExpress.ExpressApp.Win.WinApplication.DoLogon()
at DevExpress.ExpressApp.Win.WinApplication.Start()
InnerException is null

目前可通过三种临时方案规避该问题：

• 打开安装View Variants模块前的旧版本应用副本完成登录，后续即可正常使用新版本
• 删除用户Roaming目录下对应应用的ModulesVersionInfo文件，应用可正常启动
• 删除应用程序部署目录下的modelassembly.dll文件，即可解决启动报错

该异常属于XAF应用模型缓存版本不兼容问题：

1. View Variants模块会扩展XAF应用模型层，为所有视图节点追加IModelViewVariants接口实现，用于存储视图变体配置
2. 本地开发环境每次编译调试时，会自动清理旧的模型生成缓存，基于当前最新加载的模块集重新生成模型元数据，因此不会触发报错
3. 生产环境部署时如果直接覆盖文件，会残留两类旧缓存：一是部署目录下旧版本预生成的modelassembly.dll，二是用户Roaming目录下基于旧模块集生成的用户模型差异、版本校验文件ModulesVersionInfo。这两类缓存中的ModelDetailView节点没有实现IModelViewVariants接口
4. View Variants模块启动时遍历视图节点读取变体配置，尝试将节点转换为IModelViewVariants类型时，遇到旧缓存中未实现该接口的节点就会抛出InvalidCastException。

上述三个临时方案的本质都是手动清理了某一层的旧模型缓存，强制应用基于当前模块集重新生成模型元数据，因此可以临时绕过问题。

• 规范部署流程：每次发布新版本（尤其是新增/移除核心模块、升级DevExpress版本时），先清空部署目录下所有自动生成的模型缓存文件，包括modelassembly.dll、*.GeneratedModules文件夹、根目录下的Model.User.xafml文件，不要把开发环境生成的modelassembly.dll打包进部署包
• 增加缓存自动失效逻辑：在WinApplication实现类中重写GetModelCacheFileVersion方法，返回值拼接当前所有已加载模块的版本标识、模块列表哈希值，当模块集发生变化时自动判定旧缓存失效，强制重建模型缓存，无需手动删除文件
• 升级版本时同步更新应用程序集版本号：XAF会自动对比已记录的模块版本与当前运行版本，版本号变化时会自动跳过不兼容的用户模型缓存加载，避免旧缓存干扰新的模型生成流程
• 若需要保留用户自定义的模型差异（比如用户自定义的视图布局），可以实现模型差异转换逻辑，在版本升级时自动给旧的用户模型节点补全IModelViewVariants相关的属性节点，避免直接加载旧格式的模型配置。

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