System.Linq.Dynamic.Core 字符串转义解析问题分析与解决方案

问题背景

在 System.Linq.Dynamic.Core 1.3.10 版本中，存在一个字符串转义解析的问题。当使用 DynamicExpressionParser 解析包含连续转义序列的字符串时，特别是处理 JSON 格式字符串时，解析结果与预期不符。

问题重现

考虑以下代码示例：

DynamicExpressionParser
    .ParseLambda(typeof(object), "\"{\\\"PropertyA\\\":\\\"\\\"}\"")
    .Compile()
    .DynamicInvoke()

预期输出应为："{\"PropertyA\":\"\"}" 实际输出却是："{\"PropertyA\":\"}"

技术分析

这个问题源于字符串转义处理逻辑的不足。在 C# 字符串中，反斜杠()用作转义字符。当处理多层转义时，特别是处理 JSON 字符串（本身就包含大量转义字符）时，解析器未能正确处理连续的转义序列。

具体来说，当遇到 \\\" 这样的序列时：

1. 前两个反斜杠 \\ 应被解析为单个反斜杠 \
2. 接下来的 \" 应被解析为双引号 "

但在 1.3.10 版本中，解析器错误地将连续的转义序列合并处理，导致输出不正确。

解决方案

在 1.3.11-preview-01 版本中，这个问题已被修复。开发者引入了新的配置选项 StringLiteralParsingType 来提供更灵活的字符串解析方式：

public enum StringLiteralParsingType : byte
{
    /// <summary>
    /// 默认字符串解析类型，使用标准转义方式
    /// 例如：var expression = "StaticHelper.Filter(\"UserName == \\\"x\\\"\")";
    /// [默认值]
    /// </summary>
    Default = 0,

    /// <summary>
    /// 使用双引号转义双引号的解析类型
    /// 例如：var expression = "StaticHelper.Filter(\"UserName == \"\"x\"\"\")";
    /// </summary>
    EscapeDoubleQuoteByTwoDoubleQuotes = 1
}

使用建议

1. 对于大多数情况，使用默认的 StringLiteralParsingType.Default 即可
2. 如果需要与旧版本兼容，可以使用 EscapeDoubleQuoteByTwoDoubleQuotes 选项
3. 处理 JSON 字符串时，确保转义层级正确：
   • 原始 JSON: {"PropertyA":""}
   • C# 字符串表示: "{\\\"PropertyA\\\":\\\"\\\"}"

最佳实践

当需要在动态表达式中使用包含转义字符的字符串时：

// 推荐方式（1.3.11+）
var result = DynamicExpressionParser
    .ParseLambda(typeof(object), "\"{\\\"PropertyA\\\":\\\"\\\"}\"")
    .Compile()
    .DynamicInvoke();

对于需要向后兼容的场景：

// 配置使用旧版解析方式
var config = new ParsingConfig
{
    StringLiteralParsingType = StringLiteralParsingType.EscapeDoubleQuoteByTwoDoubleQuotes
};

var result = DynamicExpressionParser
    .ParseLambda(config, typeof(object), "\"{\"\"PropertyA\"\":\"\"\"\"}\"")
    .Compile()
    .DynamicInvoke();

总结

System.Linq.Dynamic.Core 1.3.11 版本修复了字符串转义解析的问题，并提供了更灵活的配置选项。开发者现在可以根据需要选择适合的字符串解析方式，确保动态表达式中的字符串能够被正确解析和处理。