D365开发环境升级后单元测试出现序列化版本不匹配问题求助

问题描述 #

开发环境完成Service Update 10.0.39更新、模型构建及数据库同步后，运行单元测试时触发错误：
Serialization version mismatch detect, make sure the runtime dlls are in sync with the deployed metadata. Version of file '209'. Version of dll '208'

已确认D365仪表板可正常打开、服务更新成功，尝试过以下操作但问题未解决：

• 停止SQL Reporting服务
• 停止IIS
• 刷新模型
• 完整构建自定义模型并同步数据库

针对性解决步骤 #

1. 清理本地元数据缓存 #

• 关闭所有Visual Studio实例
• 删除以下目录下的全部缓存文件：
  • C:\Users\<你的用户名>\AppData\Local\Microsoft\DynamicsAx\Cache
  • C:\Program Files (x86)\Microsoft Visual Studio\<VS版本>\Common7\IDE\Extensions\Microsoft\Dynamics 365 Finance Operations\MetadataCache

2. 全量模型构建与同步 #

• 打开Visual Studio，选中解决方案中所有模型（含系统模型及自定义模型）
• 执行完整构建（Full Build），等待构建过程无报错完成
• 执行完整数据库同步（Full Database Sync），确保同步日志无异常

3. 检查并更新单元测试项目引用 #

• 右键单元测试项目 → 管理NuGet程序包
• 筛选所有Microsoft.Dynamics.*开头的NuGet包，确认版本与Service Update 10.0.39完全一致
• 若存在版本不匹配，更新至对应版本后重新构建测试项目

4. 重启AOS服务 #

• 打开Windows服务控制台，找到Microsoft Dynamics 365 Unified Operations: AOS服务
• 停止服务后等待30秒，再重新启动
• 启动完成后等待5分钟，确保服务完成初始化

5. 验证测试运行环境配置 #

• 右键单元测试项目 → 属性 → 切换至Debug选项卡
• 确认启动程序指向本地开发环境的D365服务路径，避免使用远程环境配置

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