.NET 8中使用Google Cloud Storage SDK时AccessToken为空的解决求助

架构老林

2026-6-22

问题分析与解决方案

你遇到的核心问题是使用了OAuth授权用户凭证（type: authorized_user），但该凭证缺少refresh_token字段，导致无法自动刷新过期的访问令牌，甚至加载时出现凭证对象异常的情况。以下是两种可行的解决方法：

方案一：使用服务账号凭证（推荐用于后端应用）

服务账号是GCP推荐的服务器端访问方式，无需依赖用户令牌刷新：

前往GCP凭证管理页面，创建服务账号密钥（注意不是OAuth客户端ID），下载JSON格式的密钥文件（文件类型为service_account）
在代码中加载凭证并指定GCS只读权限：

GoogleCredential credential = GoogleCredential.FromFile("你的服务账号密钥文件路径.json")
    .CreateScoped(StorageService.Scope.CloudPlatformReadOnly);
var storageClient = StorageClient.Create(credential);

给服务账号授予存储桶权限：在GCS存储桶的权限设置中，添加服务账号的邮箱地址，分配Storage Object Viewer角色

方案二：修复授权用户凭证（适合需要模拟特定用户访问的场景）

如果必须使用用户类型的OAuth凭证，需要确保凭证包含刷新令牌：

重新走OAuth授权流程，务必请求offline_access权限范围，这样才能获取到refresh_token
替换现有凭证文件，确保文件中包含refresh_token字段
代码中指定GCS的访问范围：

var credential = GoogleCredential.FromFile("你的授权用户凭证文件路径.json")
    .CreateScoped(new[] { "https://www.googleapis.com/auth/devstorage.read_only" });
var storageClient = StorageClient.Create(credential);