C# .NET5 Google Sheets API服务账号授权报Invalid JWT Signature错误
问题根因与修复方案
直接导致Invalid JWT Signature错误的代码问题
- 对
ServiceAccountCredential.Initializer的User属性使用逻辑完全错误
该属性仅适用于服务账号开启全域委派、需要模拟Google Workspace域内普通用户身份调用API的场景,取值必须是被模拟的普通用户邮箱。你在代码中把该值设为服务账号自身的邮箱,会在JWT声明中生成逻辑矛盾的内容,直接触发Google端的签名校验失败。 - 手动重建凭证的操作冗余且破坏了原有凭证的正确结构
通过GoogleCredential.FromStream(stream)读取到的对象,本身就是加载了完整RSA密钥对、具备合法JWT签名能力的服务账号凭证。你强行拆分底层凭证、重新手动创建Initializer的过程中,没有完整保留原凭证的密钥格式、令牌端点配置,会进一步导致生成的JWT签名与Google后台留存的公钥不匹配。
代码修正方案
直接删除冗余的手动重建凭证逻辑,使用SDK原生提供的凭证初始化能力即可:
private static readonly string[] Scopes = { SheetsService.Scope.Spreadsheets }; public static ServiceAccountCredential Credential { get; private set; } public static void Setup() { using Stream stream = new FileStream("credentials.json", FileMode.Open, FileAccess.Read, FileShare.Read); // 直接加载合法凭证,仅绑定需要的权限范围 var credential = GoogleCredential.FromStream(stream) .CreateScoped(Scopes); Credential = (ServiceAccountCredential)credential.UnderlyingCredential; }
容易遗漏的前置配置项
- 确认目标Google Sheets文件已经共享给
credentials.json文件中记录的服务账号邮箱,根据业务需要配置查看/编辑权限,否则哪怕签名校验通过,也会触发后续的权限类报错。 - 确认本地运行环境的系统时间与标准网络时间的偏差不超过5分钟:JWT自带时效校验逻辑,时间偏差过大会直接返回
invalid_grant类的认证错误。 - 部署到Docker环境时,需要将
credentials.json的文件复制属性设置为“如果较新则复制”,确保容器运行时能读取到完整的凭证内容——文件读取不完整会直接导致密钥加载异常,生成的JWT签名必然校验失败。 - 如果确实需要使用全域委派的模拟用户能力,必须将
User属性设为待模拟的普通域用户邮箱,同时确认服务账号在Google后台已经开通了对应API权限范围的全域委派授权。
内容的提问来源于stack exchange,提问作者Shadr
相关产品推荐
相关产品推荐

