Azure Tables Storage查询返回501 Not Implemented错误

触发501 Not Implemented的核心原因有两个：

1. OData筛选器语法不合法：查询过滤条件中字符串类型的值未用单引号包裹。你当前写的$"RowKey eq Test"会被OData解析为「判断RowKey字段等于实体上名为Test的属性值」，而非匹配字符串常量Test，Azure Table服务无法解析这类语法错误时，不会返回常规400错误，而是直接返回501 NotImplemented。
2. 实体类属性定义冲突：你的EndpointEntity类中重复定义了Timestamp属性：一个是自定义的DateTime类型公共属性，另一个是显式实现ITableEntity接口的DateTimeOffset?类型属性。类型不匹配的同名属性会导致SDK生成不符合服务端规范的请求载荷，直接触发服务端报错。

按以下步骤调整代码即可解决问题：

• 修正查询过滤语法，所有字符串常量必须用单引号包裹，修改查询代码为：

var serviceClient = new TableServiceClient(_configuration["StorageConnectionString"]);
var tableClient = serviceClient.GetTableClient(TableName);
// 字符串值'Test'加单引号
Pageable<EndpointEntity> queryResultsFilter = tableClient.Query<EndpointEntity>(filter: $"RowKey eq 'Test'");
var entities = queryResultsFilter.ToList();

• 修复实体类的Timestamp属性定义，删除自定义的DateTime类型Timestamp属性，仅保留符合ITableEntity接口要求的DateTimeOffset?类型属性，修正后的实体类代码：

public class EndpointEntity : ITableEntity
{
    public string PartitionKey { get; set; }
    public string RowKey { get; set; }
    // 直接使用接口要求的DateTimeOffset?类型，不要重复定义
    public DateTimeOffset? Timestamp { get; set; }
    public DateTime PerformanceDate { get; set; }
    public double TotalProcessingTimeMilliseconds { get; set; }
    public string JourneyID { get; set; }
    public DateTime ExpiryDate { get; set; }
    public string EntityType { get; set; }
    public ETag ETag { get; set; }
}

• 补充校验：如果修改后仍报错，请确认连接字符串指向的是支持表服务的通用存储账户（通用v1/v2、表存储专用账户均可），如果误用了仅启用Blob/ADLS Gen2服务的存储端点，也会返回501错误，该场景概率极低。

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