GCP共享VPC添加服务项目报错404：项目资源未找到（项目已存在）

问题重现 #

执行以下命令尝试将项目添加为共享VPC服务项目：

gcloud --impersonate-service-account=network-admin@redacted-project-1-id.iam.gserviceaccount.com compute shared-vpc associated-projects add --host-project=main-shared-vpc-host-redacted-id redacted-project-1-id

返回错误：

WARNING: This command is using service account impersonation. All API calls will be executed as [network-admin@redacted-project-1-id.iam.gserviceaccount.com].
WARNING: This command is using service account impersonation. All API calls will be executed as [network-admin@redacted-project-1-id.iam.gserviceaccount.com].
ERROR: (gcloud.compute.shared-vpc.associated-projects.add) Could not enable resource [redacted-project-1-id] as an associated resource for project [main-shared-vpc-host-redacted-id]:
 - The resource 'projects/redacted-project-1-id' was not found

已知条件：

• network-admin@redacted-project-1-id.iam.gserviceaccount.com存在于redacted-project-1-id项目中，确认项目实际存在
• 其他项目已成功关联至该共享VPC主机项目

可能原因及解决方案 #

1. impersonate的服务账号权限不足 #

用于执行命令的服务账号需要同时具备主机项目和目标项目的必要权限：

• 主机项目侧：需要compute.sharedVpcAssociate权限（或Compute Shared VPC Admin角色），允许将服务项目关联到主机VPC
• 目标项目侧：需要resourcemanager.projects.get权限（通常包含在Viewer角色中），确保主机项目能读取目标项目的存在状态

解决步骤：

• 在主机项目main-shared-vpc-host-redacted-id中，给network-admin@redacted-project-1-id.iam.gserviceaccount.com授予Compute Shared VPC Admin角色
• 确认目标项目redacted-project-1-id中，该服务账号至少拥有Viewer角色

2. 目标项目未启用Compute Engine API #

共享VPC关联要求服务项目必须启用Compute Engine API，否则主机项目无法识别该项目为合法的服务项目资源。

解决步骤：
执行命令启用目标项目的Compute Engine API：

gcloud --impersonate-service-account=network-admin@redacted-project-1-id.iam.gserviceaccount.com services enable compute.googleapis.com --project=redacted-project-1-id

3. 组织政策限制 #

GCP组织级政策可能限制了共享VPC的关联范围，例如禁止特定项目关联到共享VPC，或要求项目属于指定组织单元。

解决步骤：

• 检查组织中的constraints/compute.restrictSharedVpcHostProjects和constraints/compute.restrictSharedVpcServiceProjects政策
• 确认redacted-project-1-id不在限制列表中，如有需要调整政策允许该项目关联

4. 目标项目状态异常 #

即使服务账号存在，项目可能处于暂停、关闭或待删除状态，导致主机项目无法正常读取项目信息。

解决步骤：

• 登录GCP控制台，查看redacted-project-1-id项目的状态，确保项目处于正常启用状态
• 确认项目未处于删除流程或被标记为异常

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