使用TableOutput写入、TableClient读取时String转Int类型转换错误排查

问题原因 #

Azure表存储确实是无模式的，但你遇到的问题源于读写两端的序列化/反序列化逻辑不一致：

• Azure Functions隔离模式的TableOutput绑定：依赖旧版Microsoft.Azure.WebJobs.Extensions.Tables的序列化逻辑，会将C#的int属性序列化为表存储中的String类型（而非Int32类型）。
• Azure.Data.Table.TableClient (v12.10.0)：读取时会严格匹配表存储中实际存储的类型。当它遇到存储为String的数值，尝试映射到C#的int属性时，就会抛出Unable to cast object of type 'System.String' to type 'System.Int32'异常。

改成long属性可以解决问题，是因为TableClient的反序列化逻辑对long类型做了兼容：允许将存储的String数值自动转换为long（只要数值在范围内），但int属性没有这个自动转换逻辑，必须要求存储类型为Int32。你用TableEntity验证数值范围没问题，也佐证了问题出在类型存储/映射的匹配上，和数值本身无关。

合理的预防措施 #

1. 统一读写的SDK逻辑 #

放弃TableOutput绑定，写入数据时也使用Azure.Data.Table.TableClient，确保int属性被正确序列化为表存储的Int32类型，读取时就不会出现类型不匹配：

// 使用TableClient写入示例
var myData = new MyData 
{ 
    PartitionKey = "val", 
    RowKey = "row1", 
    NumOranges = 5,
    NumApples = 3,
    NumBananas = 2
};
await tableClient.UpsertEntityAsync(myData);

2. 自定义实体的序列化/反序列化（保留TableOutput绑定的场景） #

如果必须使用TableOutput绑定，可以实现ITableEntity接口，手动控制属性的读写逻辑，确保数值类型被正确处理：

public class MyData : ITableEntity
{
    public string PartitionKey { get; set; }
    public string RowKey { get; set; }
    public DateTimeOffset? Timestamp { get; set; }
    public ETag ETag { get; set; }

    public int NumOranges { get; set; }
    public int NumApples { get; set; }
    public int NumBananas { get; set; }

    // 自定义反序列化：处理表存储中String类型转int
    public void ReadEntity(IDictionary<string, EntityProperty> properties, OperationContext operationContext)
    {
        PartitionKey = properties[nameof(PartitionKey)].StringValue;
        RowKey = properties[nameof(RowKey)].StringValue;
        
        if (properties.TryGetValue(nameof(NumOranges), out var orangesProp))
            NumOranges = int.Parse(orangesProp.StringValue);
        if (properties.TryGetValue(nameof(NumApples), out var applesProp))
            NumApples = int.Parse(applesProp.StringValue);
        if (properties.TryGetValue(nameof(NumBananas), out var bananasProp))
            NumBananas = int.Parse(bananasProp.StringValue);
    }

    // 自定义序列化：强制将int按Int32类型写入表存储
    public IDictionary<string, EntityProperty> WriteEntity(OperationContext operationContext)
    {
        return new Dictionary<string, EntityProperty>
        {
            { nameof(PartitionKey), EntityProperty.CreateEntityPropertyFromString(PartitionKey) },
            { nameof(RowKey), EntityProperty.CreateEntityPropertyFromString(RowKey) },
            { nameof(NumOranges), EntityProperty.CreateEntityPropertyFromInt32(NumOranges) },
            { nameof(NumApples), EntityProperty.CreateEntityPropertyFromInt32(NumApples) },
            { nameof(NumBananas), EntityProperty.CreateEntityPropertyFromInt32(NumBananas) }
        };
    }
}

3. 使用兼容的数值类型 #

如果不想修改读写逻辑，可以将实体类的数值属性统一改为long（即你使用的临时方案），利用TableClient对long类型的自动转换兼容特性，避免类型转换异常。

额外说明 #

Azure表存储的无模式特性指的是不同实体可以拥有不同属性，但每个属性的存储类型是固定的。跨SDK使用时，必须保证读写两端的序列化逻辑对齐，否则就会出现这类类型不兼容问题。

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