用途:该技能针对 Google Cloud 认证缺失与 Application Default Credentials(ADC)问题进行识别与处理,适用于 gcloud、bq 等命令行工具以及 Python/Notebook 环境。
常见错误信息:gcloud/bq CLI 可能提示“You do not currently have an active account selected.”“No credentialed accounts.”“Configuration error: No account is currently active.”;Python/Notebook 可能抛出 google.auth.exceptions.DefaultCredentialsError: Could not automatically determine credentials.,或出现 Forbidden: 403 Access Denied(当实为认证问题时)。
验证步骤:在要求用户登录前,先独立核实认证状态,运行 gcloud auth list。若输出包含“No credentialed accounts.”,进入纠正步骤。若已列出账户但仍收到 403 Access Denied,问题更可能是该活跃账户的 IAM 权限(如缺少 BigQuery 角色),而非认证缺失,此时应排查权限,而不是再次要求登录。
纠正措施:确认凭据缺失后,不要通过代码或替代工具修复凭据,凭据必须由用户建立。应停止并请用户在终端运行:gcloud auth login(认证 gcloud CLI),以及 gcloud auth application-default login(设置 ADC,BQ CLI 及多数库/Notebook 所需)。
登录后验证:用户确认已登录后,用 gcloud auth list 验证,然后继续原任务。
限制:该技能仅涉及认证识别与排查指引,不授予权限,也不替代 IAM 配置;其余细节暂未提供。