Azure.Data.Tables.TableClient查询抛出常量表达式转换异常问题

问题场景 #

执行以下查询代码时触发异常：

var deviceName = "test";
var pendingRequest = await tableClient
                    .QueryAsync<AttestationDetailWrapper>(x => x.DeviceName == deviceName )
                    .AnyAsync(req.HttpContext.RequestAborted);

异常信息：

System.InvalidOperationException: 'Could not convert constant test expression to string.'

对应的Azure表已创建且为空，包含字段：PartitionKey、RowKey、Timestamp、DeviceName。

相关类定义：

public class AttestationDetail
{
    public Guid Id { get; set; } // 唯一的证明请求（设备未来可再次注册）
    public string DeviceName { get; set; } = string.Empty;
    public Guid Tenant { get; set; } // 此注册所属的租户
}

internal sealed class AttestationDetailWrapper : AttestationDetail, ITableEntity
{
    public string PartitionKey
    {
        get => Tenant.ToString();
        set => Tenant = Guid.Parse(value);
    }

    public string RowKey
    {
        get => Id.ToString();
        set => Id = Guid.Parse(value);
    }
    public DateTimeOffset? Timestamp { get; set; }
    public ETag ETag { get; set; }
}

问题原因 #

Azure.Data.Tables的Lambda表达式查询解析器对继承自父类的属性存在解析限制，无法正确处理父类中定义的DeviceName属性与常量的比较逻辑，进而触发类型转换异常。

解决方案 #

方案1：使用字符串过滤器替代Lambda表达式 #

直接构建OData格式的查询字符串，绕过Lambda解析的局限性：

var deviceName = "test";
// 安全构建过滤器，避免特殊字符导致的语法错误
var filter = TableClient.CreateQueryFilter($"DeviceName eq @deviceName", new { deviceName });
var pendingRequest = await tableClient
                    .QueryAsync<AttestationDetailWrapper>(filter)
                    .AnyAsync(req.HttpContext.RequestAborted);

方案2：将属性移至实现ITableEntity的子类 #

把DeviceName属性从父类AttestationDetail迁移到AttestationDetailWrapper中，确保查询解析器能直接识别该属性：

public class AttestationDetail
{
    public Guid Id { get; set; } // 唯一的证明请求（设备未来可再次注册）
    public Guid Tenant { get; set; } // 此注册所属的租户
}

internal sealed class AttestationDetailWrapper : AttestationDetail, ITableEntity
{
    public string DeviceName { get; set; } = string.Empty;
    public string PartitionKey
    {
        get => Tenant.ToString();
        set => Tenant = Guid.Parse(value);
    }

    public string RowKey
    {
        get => Id.ToString();
        set => Id = Guid.Parse(value);
    }
    public DateTimeOffset? Timestamp { get; set; }
    public ETag ETag { get; set; }
}

修改后原Lambda查询语句即可正常执行。

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