调用Vertex AI服务遇403权限错误求助

开发者阿泽

2026-7-7

解决Vertex AI调用的权限拒绝问题

针对你遇到的403权限错误，结合你提到的两个情况，按以下步骤排查：

检查代码中的项目ID配置
Python调用Vertex AI时，若代码中显式指定了项目ID，会覆盖gcloud的全局配置。确认初始化客户端的代码是否设置了正确的项目：
```
import vertexai
vertexai.init(project="你的实际项目ID")
```
同时检查是否存在GOOGLE_CLOUD_PROJECT环境变量，若该变量设置为错误项目，也会导致此问题。
验证应用默认凭据（ADC）关联的项目
Google Cloud Python客户端优先使用应用默认凭据，而非gcloud的config set project配置。你可以通过以下命令查看当前ADC对应的项目：
```
gcloud auth application-default describe
```
若返回的项目不是你实际使用的，重新生成ADC：
```
gcloud auth application-default login
```
登录流程中选择正确的项目即可；如果使用服务账号，确保GOOGLE_APPLICATION_CREDENTIALS环境变量指向正确的服务账号密钥文件，且该密钥属于你的目标项目。
确认目标项目已启用Vertex AI API
务必在你实际使用的项目中启用Vertex AI API，错误提示中的项目名不代表当前实际调用的项目，以你代码/凭据关联的项目为准。
检查凭据的权限
确保你使用的账号（用户账号或服务账号）在目标项目中拥有Vertex AI User或更高权限（如Editor角色），无权限会导致即使API启用也无法调用。