Dataverse多程序集NuGet包中LINQ查询类型转换异常求助

问题根源 #

当模型程序集与插件程序集分开部署时，Dataverse的插件加载上下文无法正确识别模型程序集中的代理类型，导致LINQ查询返回Microsoft.Xrm.Sdk.Entity而非预期的强类型实体，进而触发类型转换失败。合并程序集能解决问题，是因为所有类型处于同一加载上下文，代理类型可被自动识别。

解决方案 #

1. 确保依赖程序集正确部署 #

• 打包NuGet插件包时，将模型程序集作为直接依赖项包含，确保部署到Dataverse时，模型DLL与3个插件DLL处于同一插件包目录下。Dataverse插件加载器只会从当前插件包目录加载依赖，路径错误会导致无法找到模型程序集。
• 检查模型程序集的强名称：如果模型程序集有强名称，所有引用它的插件程序集必须引用完全相同版本的强名称程序集，版本不匹配会导致加载失败。

2. 显式注册代理类型程序集 #

在每个插件的Execute方法开头，显式注册模型程序集，强制插件加载上下文识别代理类型：

// 替换为你模型程序集中的任意实体类型
var modelAssembly = typeof(XXX.Customer.Project.Model.Account).Assembly;
Microsoft.Xrm.Sdk.Client.ProxyTypesAssemblyAttribute.RegisterAssembly(modelAssembly);

这一步确保每个插件实例执行时，都明确加载并注册模型程序集，而非依赖自动发现。

3. 验证实体元数据一致性 #

• 重新用PAC CLI生成模型时，确保使用当前Dataverse环境的最新元数据，避免生成的SystemUser或自定义实体类的LogicalName、属性名称与实际环境不匹配。
• 检查模型类的EntityLogicalNameAttribute和属性的AttributeLogicalNameAttribute，确认与Dataverse实体的元数据完全一致。

4. 调整插件注册方式 #

使用插件注册工具部署时，选择包含所有依赖项，将4个DLL打包到同一个插件包中。不要分开部署模型程序集和插件程序集，否则Dataverse无法在插件加载时找到依赖的模型类型。

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