创建Google Cloud Platform订阅时出现Resource not found(resource=<my-subscription-id>)错误

可能的原因及解决步骤 #

• 订阅ID命名不符合规范
  检查你的<my-subscription-id>是否遵循GCP命名规则：仅允许小写字母、数字和连字符，不能以连字符开头/结尾，长度3-255字符。不符合的话修改ID后重试。

• 权限配置不完整

  • 确保操作账号拥有pubsub.subscriptions.create权限（比如分配Pub/Sub Editor角色）。
  • 因为要写入BigQuery，还需确保账号有bigquery.tables.create、bigquery.datasets.update权限（针对目标数据集），同时Pub/Sub的默认服务账号（service-<project-number>@gcp-sa-pubsub.iam.gserviceaccount.com）需要被授予BigQuery Data Editor角色（针对目标数据集）。

• 主题Schema状态异常
  确认关联到主题的Schema处于ACTIVE状态，且主题确实正确绑定了该Schema。如果Schema已删除或未关联，勾选Use topic schema会导致创建失败，可前往Pub/Sub Schema页面验证状态。

• BigQuery目标配置错误

  • 检查目标BigQuery数据集是否存在，且区域与Pub/Sub主题区域一致（跨区域可能引发兼容性问题）。
  • 若选择自动创建新表，确认数据集允许创建新表；若使用现有表，检查表结构与主题Schema完全兼容。

• 临时服务或网络问题
  GCP服务偶尔会有临时波动，或本地网络不稳定导致请求异常。可等待几分钟后重试，或使用隐身窗口访问控制台尝试创建。

• 用命令行排查详细错误
  若控制台报错信息模糊，尝试用gcloud命令行创建订阅，获取更精准的错误提示：

  gcloud pubsub subscriptions create <my-subscription-id> --topic=<your-topic-id> --bigquery-table=<your-project>:<your-dataset>.<your-table> --use-topic-schema
  

内容的提问来源于stack exchange，提问作者Naga - MS