部署到服务器时Google Storageclient.ListObjects触发线程取消问题

问题场景 #

一段从Google Cloud Storage（GCS）获取文件的代码在本地开发环境运行正常，但部署到生产服务器后，只要实际操作objectsInBucket（PagedEnumerable类型变量）就会出现程序“停止”的现象：

• 原代码部署后，最后正常输出的日志为-6，后续对objectsInBucket的Where操作无进展
• 取消注释foreach循环后，最后输出的日志为-4
• 在objectsInBucket = storageClient.ListObjects(_gcsBucketName);后添加var count = objectsInBucket.Count();，最后输出的日志为-2

注意：storageClient.ListObjects返回的PagedEnumerable是延迟加载的，仅在调用Count()、foreach或后续枚举操作时，才会真正向GCS发起API请求——这意味着程序“停止”的时机，正好是发起API请求的节点。

可能的原因 #

• 网络/防火墙限制
  生产服务器的网络策略禁止访问GCS服务地址（storage.googleapis.com），或者未配置正确的网络代理。本地开发环境通常不受此类限制，而生产环境的出站流量被拦截后，程序会因等待网络响应进入无限阻塞状态。

• 身份验证或权限问题
  生产环境的GCS客户端身份验证配置错误：

  • 未正确设置服务账号密钥（比如未配置GOOGLE_APPLICATION_CREDENTIALS环境变量、密钥文件路径错误或权限不足）
  • 服务账号缺少storage.objects.list权限，导致API请求被拒绝或进入重试循环，程序无响应。

• 客户端超时配置缺失
  默认的GCS客户端未设置合理的超时时间，当生产环境网络波动、API响应延迟时，程序会持续等待响应，表现为“停止”。本地环境网络条件好，请求快速完成，因此未暴露该问题。

排查建议 #

1. 验证生产服务器网络连通性
   在生产服务器上执行以下操作测试GCS访问：

   # 测试域名解析
   nslookup storage.googleapis.com
   # 测试API访问（需先获取有效令牌）
   curl -H "Authorization: Bearer $(gcloud auth print-access-token)" https://storage.googleapis.com/storage/v1/b/[你的Bucket名称]/o
   

   若无法返回结果，需调整网络防火墙或代理配置。

2. 检查身份验证与权限

   • 确认生产环境已正确配置服务账号密钥，密钥文件路径正确、权限为600（仅所有者可读）
   • 验证服务账号是否拥有storage.objects.list权限：可在GCP控制台的IAM页面查看该账号的权限配置

3. 添加超时与异常捕获
   在代码中添加超时配置，并捕获API调用时的异常，便于定位问题：

   // 创建客户端时设置超时
   var storageClient = new StorageClientBuilder
   {
       HttpClient = new HttpClient { Timeout = TimeSpan.FromSeconds(30) },
       // 配置重试策略（可选）
       RetrySettings = RetrySettings.FromMaxAttempts(3, TimeSpan.FromSeconds(2))
   }.Build();
   
   // 枚举操作添加异常捕获
   try
   {
       LogHelper.LogToConsole($" - 4");
       var count = objectsInBucket.Count();
       LogHelper.LogToConsole($" - {count} attachments exists on bucket:");
       foreach (var obj in objectsInBucket)
       {
           LogHelper.LogToConsole($" - - {obj.Name}");
       }
       LogHelper.LogToConsole($" - 5");
   }
   catch (Exception ex)
   {
       LogHelper.LogToConsole($" - Error accessing GCS: {ex.Message}\nStack Trace: {ex.StackTrace}");
   }
   

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