Elsa Workflows 中 C Script 对 ExpandoObject 的点表示法支持问题解析

背景介绍

在 Elsa Workflows 工作流引擎中，开发者可以使用多种脚本语言来实现业务逻辑，其中包括 C# Script 和 JavaScript。当处理 JSON 类型变量时，Elsa 内部实际上是使用 .NET 的 ExpandoObject 类型来表示这些动态数据结构。

问题现象

开发者在 C# Script 中尝试使用点表示法访问 ExpandoObject 属性时遇到了编译错误。例如，对于名为 Variable1 的 JSON 类型变量，尝试使用 Variables.Variable1.MyProperty 会抛出以下错误：

error CS1061: 'ExpandoObject' does not contain a definition for 'MyProperty' and no accessible extension method 'MyProperty' accepting a first argument of type 'ExpandoObject' could be found

而同样的操作在 JavaScript 环境中却可以正常工作，如 getVariable1().MyProperty。

技术原理分析

这个问题源于 C# 的静态类型检查机制与动态类型之间的不匹配：

1. ExpandoObject 本质：ExpandoObject 实现了 IDynamicMetaObjectProvider 接口，允许在运行时动态添加和删除成员。

2. C# 静态类型检查：C# 编译器在编译时会对类型进行严格检查，而 ExpandoObject 在编译时并不包含动态添加的属性。

3. JavaScript 差异：JavaScript 本身就是动态类型语言，天生支持运行时属性访问，因此不会遇到类似问题。

解决方案探讨

推荐解决方案

最优雅的解决方案是修改 Elsa 的 C# 脚本评估器，将 ExpandoObject 显式地作为 dynamic 类型处理。这样可以利用 C# 的动态类型特性，在运行时解析属性访问。

替代方案

1. 使用 JavaScript：如果业务逻辑允许，可以改用 JavaScript 来实现相关功能，避免类型系统限制。

2. 显式类型转换：

   • 将 ExpandoObject 转换为 dynamic 类型：((dynamic)Variables.Variable1).MyProperty
   • 使用字典式访问：((IDictionary<string,object>)Variables.Variable1)["MyProperty"]

3. 自定义包装器：创建一个帮助类，提供对 ExpandoObject 更友好的访问接口。

实现建议

对于 Elsa 项目维护者，建议在 C# 脚本评估器中实现以下改进：

1. 自动检测 ExpandoObject 类型的变量
2. 在编译时将这类变量标记为 dynamic 类型
3. 确保变量访问使用动态绑定而非静态绑定

开发者实践指南

对于需要使用 C# Script 处理 JSON 数据的开发者，可以采取以下最佳实践：

1. 明确类型转换：在访问动态属性前，先进行类型转换

   var dynamicObj = (dynamic)Variables.Variable1;
   var value = dynamicObj.MyProperty;
   

2. 使用安全访问模式：考虑到属性可能不存在，应添加适当的错误处理

   try {
       var value = ((dynamic)Variables.Variable1).MyProperty;
   } catch (RuntimeBinderException) {
       // 处理属性不存在的情况
   }
   

3. 考虑性能影响：动态类型访问比静态类型访问有性能开销，在性能敏感场景需谨慎使用。

总结

在 Elsa Workflows 中使用 C# Script 处理 JSON/ExpandoObject 时，开发者需要理解静态类型语言处理动态数据的限制。虽然目前需要一些额外处理，但通过合理的类型转换和错误处理，仍然可以实现所需功能。期待未来版本能够原生支持更优雅的动态属性访问方式。