Azure Table Storage：TableClient无法返回ETag问题求助

使用Azure.Data.Table的TableClient执行简单查询时，返回的自定义实体ETag属性为空（序列化后显示为"eTag": {}），但实体已经实现了ITableEntity接口，包含ETag属性。

问题代码示例 #

var tableClient = new TableClient(
    new Uri(storageUri),
    tableName,
    new TableSharedKeyCredential(accountName, storageAccountKey));
    
var response = await tableClient.GetEntityAsync<TEntity>(partitionKey, rowKey);

return response.Value;

序列化输出结果 #

{
    "partitionKey": "Partition Key",
    "rowKey": "RowKey",
    "timestamp": "2023-02-07T20:55:45.6532507+00:00",
    "eTag": {},
    "forename": "Forename",
    "surname": "Surname",
    "mobile": "Mobile",
    "address": "Address"
}

更新测试信息
分别用TableEntity和自定义User类型测试：
自定义User类定义：

public class User : ITableEntity, IResult
{
    public User() { }
    public string PartitionKey { get; set; }
    public string RowKey { get; set; }
    public DateTimeOffset? Timestamp { get; set; }
    public ETag ETag { get; set; }
    public string Forename { get; set; }
    public string Surname { get; set; }
    public string Mobile { get; set; }
    public string Address { get; set; }
}

测试代码：

// 此调用能正确填充所有字段及ETag
var response = await tableClient.GetEntityAsync<TableEntity>(partitionKey, rowKey);

// 此调用仅填充除ETag外的其他字段
var response = await tableClient.GetEntityAsync<User>(partitionKey, rowKey);

解决方法 #

1. 添加JsonPropertyName特性映射
   Azure SDK在处理自定义实体时，ETag对应服务端的odata.etag字段，部分JSON序列化器无法自动识别该映射，需手动指定：

using System.Text.Json.Serialization;

public class User : ITableEntity, IResult
{
    // ... 其他属性
    [JsonPropertyName("odata.etag")]
    public ETag ETag { get; set; }
    // ... 其他属性
}

2. 确认ETag类型正确性
   确保ETag属性是Azure.ETag类型（注意命名空间），避免项目中引入其他同名的ETag类导致映射失败。

3. 升级SDK版本
   旧版本的Azure.Data.Tables NuGet包可能存在自定义实体ETag填充的bug，建议升级到12.x系列的最新稳定版。

4. 从Response头直接提取ETag
   如果上述方法无效，可绕过实体属性，直接从响应头获取ETag并手动赋值：

var response = await tableClient.GetEntityAsync<User>(partitionKey, rowKey);
response.Value.ETag = response.Headers.ETag;

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