BlobContainerClient按标签查询Blob时InvalidQueryParameterValue错误排查

问题详情 #

原本通过标签筛选Blob的代码可正常运行：

var query = "Client = '"+req.Client+"' AND Type = '"+req.Type+"'";

var foundItems = sourceClient.FindBlobsByTags(query).ToList();

但添加日期参数（因SetBlobTags仅支持字符串类型）后，触发InvalidQueryParameterValue错误：

var query = "Client = '"+req.Client+"' AND Type = '"+req.Type+"' AND Timestamp >= '"+req.Date.ToString()+"'";
    
var foundItems = sourceClient.FindBlobsByTags(query).ToList();

收到的错误信息如下：

Status: 400 (Error parsing query at or near character position 45: unexpected '1')
ErrorCode: InvalidQueryParameterValue

Additional Information:
QueryParameterName: where
QueryParameterValue: Client = 'ABC' AND Type = 'Application' AND Timestamp >= '1/17/2023 1:21:56 PM'
Reason: This query parameter value is invalid.

官方文档明确存储服务支持>=运算符：

存储服务为where=expression查询参数的值支持ANSI SQL WHERE子句语法的子集。支持以下运算符：=、>、>=、<、<=、AND以及@container。示例表达式："tagKey"='tagValue'。

问题原因 #

报错核心是日期字符串格式不兼容。Blob存储的标签查询要求日期必须使用ISO 8601标准格式（如yyyy-MM-ddTHH:mm:ss.fffZ），你当前使用的1/17/2023 1:21:56 PM这类本地化格式，无法被服务端查询解析器正确识别，导致语法解析失败。

解决方法 #

将日期转换为ISO 8601标准格式后再拼入查询语句：

方法一：使用ToString("o")直接生成ISO格式 #

var query = $"Client = '{req.Client}' AND Type = '{req.Type}' AND Timestamp >= '{req.Date.ToString("o")}'";
    
var foundItems = sourceClient.FindBlobsByTags(query).ToList();

方法二：手动指定UTC标准格式 #

var isoDate = req.Date.ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ss.fffZ");
var query = $"Client = '{req.Client}' AND Type = '{req.Type}' AND Timestamp >= '{isoDate}'";
    
var foundItems = sourceClient.FindBlobsByTags(query).ToList();

额外提示：

1. 建议使用字符串插值（$""）代替字符串拼接，提升代码可读性，减少拼接错误。
2. 为避免潜在的注入风险，需确保req.Client、req.Type等输入内容不包含单引号，或提前将单引号转义为''。

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