常规问题排查

如果您在使用 Pub/Sub 时遇到问题,可查阅以下实用的问题排查步骤。

无法创建主题

确认您是否拥有必要的权限。如需创建 Pub/Sub 主题,您需要拥有项目的 Pub/Sub Editor (roles/pubsub.editor) IAM 角色。如果您没有此角色,请与您的管理员联系。如需详细了解有关主题的问题排查信息,请参阅问题排查主题排查导入主题问题

无法创建订阅

请确认您已完成以下操作:

  • 确认您是否拥有必要的权限。如需创建 Pub/Sub 订阅,您需要项目的 Pub/Sub Editor (roles/pubsub.editor) IAM 角色。如果您没有此角色,请与您的管理员联系。

  • 为订阅指定了名称。

  • 指定要将订阅附加到的现有主题的名称。

  • 如果要创建推送订阅,请在 pushEndpoint 字段中以小写字母指定 https://(而不是 http://HTTPS://)作为接收网址的协议。

如需详细了解订阅问题排查信息,请参阅排查拉取订阅问题排查推送订阅问题排查 BigQuery 订阅问题排查 Cloud Storage 订阅问题

403 (Forbidden) 个错误

如果遇到此错误,请执行以下操作:

  • 确保您已在 Google Cloud 控制台中启用了 Pub/Sub API。
  • 确保发出请求的主账号对相关 Pub/Sub API 资源具有所需权限,尤其是在您使用 Pub/Sub API 进行跨项目通信时。
  • 如果您使用的是 Dataflow,请确保 {PROJECT_NUMBER}@cloudservices.gserviceaccount.com 和 Compute Engine 服务账号 {PROJECT_NUMBER}-compute@developer.gserviceaccount.com 对相关 Pub/Sub API 资源都拥有所需的权限。如需了解详情,请参阅 Dataflow 安全和权限
  • 如果您使用的是 App Engine,请查看项目的“权限”页面,查看 App Engine 服务账号是否被列为“编辑者”。如果不是,请将您的 App Engine 服务账号添加为编辑者。通常情况下,App Engine 服务账号的格式为 <project-id>@appspot.gserviceaccount.com

使用过多的管理操作

如果您发现占用了过多管理操作配额,则可能需要重构代码。例如,请参考以下伪代码。在此示例中,管理操作 (GET) 用于在尝试使用其资源之前检查是否存在订阅。GETCREATE 都是管理操作:

if !GetSubscription my-sub {
  CreateSubscription my-sub
}
Consume from subscription my-sub

更高效的模式是尝试使用来自订阅的消息(假设您可以合理确定订阅的名称)。在这种乐观方式中,只有在出现错误时,您才会获取或创建订阅。请参考下面的示例:

try {
  Consume from subscription my-sub
} catch NotFoundError {
  CreateSubscription my-sub
  Consume from subscription my-sub
}