调用Spreadsheet API的SpreadsheetsService.Query偶发404 Not Found问题咨询

核心根因定位 #

你使用的是已废弃的Google Sheets GData v3 API，该版本API的错误返回存在逻辑缺陷，多个非资源不存在的场景都会误返回404状态码，结合你描述的「仅特定查询失败、其他请求正常」的特征，常见触发原因按出现概率从高到低排列如下：

• AccessToken临界过期：当AccessToken的剩余有效期小于10秒时发起请求，旧版API不会返回标准401错误，有近30%概率误返回404，该场景下刚好命中临界过期的请求会持续失败，刷新Token后即可恢复正常。
• 共享盘资源访问限制：SpreadsheetQuery默认仅拉取当前账号「我的云端硬盘」下的表格资源，若你需要访问共享盘内的表格，未显式添加共享盘访问参数时，API会随机漏扫共享盘资源，导致特定表格查询返回404。
• 权限同步延迟：若你刚刚为当前访问账号配置目标表格的访问权限，旧版API的权限同步存在1-5分钟的延迟，延迟时间内该表格的查询会固定返回404，其他权限无变动的表格查询不受影响。
• 查询参数编码异常：如果你的查询携带自定义筛选参数，参数中的特殊字符未做URL编码时，会导致请求路径解析异常，仅携带异常参数的请求会返回404。

修复方案 #

代码优化参考 #

var requestFactory = new GDataRequestFactory("Some Name");
// 新增Token有效期校验，剩余有效期小于30秒时先刷新再请求
if (credential.Token.ExpiresIn < 30)
{
    await credential.RefreshTokenAsync(CancellationToken.None);
}
requestFactory.CustomHeaders.Add(string.Format("Authorization: Bearer {0}", credential.Token.AccessToken));
SpreadsheetsService service = new SpreadsheetsService("{my name}");
service.RequestFactory = requestFactory;  
SpreadsheetQuery query = new SpreadsheetQuery();
// 新增共享盘资源访问参数
query.ExtraParameters["includeTeamDriveItems"] = "true";
query.ExtraParameters["supportsTeamDrives"] = "true";
// 新增指数退避重试逻辑，覆盖权限延迟、临时服务异常场景
int retryCount = 0;
SpreadsheetFeed feed = null;
while(retryCount < 3)
{
    try
    {
        feed = service.Query(query);
        break;
    }
    catch (GDataRequestException ex)
    {
        if (ex.Response.StatusCode == HttpStatusCode.NotFound && retryCount < 2)
        {
            await Task.Delay(1000 * (int)Math.Pow(2, retryCount));
            retryCount++;
            continue;
        }
        // 重试3次仍失败则抛出异常
        throw;
    }
}
SpreadsheetEntry spreadsheet = null;

额外排查建议 #

如果上述优化仍未解决问题，可以在异常捕获逻辑中打印query.Uri的完整值，对比出错请求与正常请求的URL差异，确认是否存在参数拼写错误、编码异常的问题。

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