PuppyIP 资源中心
云服务运维 5 分钟 发布于 2026-11-18

Cloud SQL PostgreSQL 私网 DNS 解析失败怎么修?

Cloud SQL for PostgreSQL 的 Private Service Connect 自动 DNS 失效时,先确认受影响的消费方 VPC,再从标准修复开始。强制修复可能短暂影响原本正常的 DNS,应放在获批的变更窗口。

Cloud SQL PostgreSQL Private Service Connect Cloud DNS

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • 自动 DNS 需要启用 PSC 和 Cloud DNS API,并至少配置一个 PSC 自动连接。
  • 逐消费方 VPC 区分实例专用域名和全局写入域名。全局写入域名需要 Enterprise Plus,且已开启对应功能。
  • 标准修复尝试恢复异常的自动配置。强制修复可能短暂中断已有的自动 DNS。
  • 修复后应从发生故障的 VPC 发起解析和新连接,确认命中了预期端点。

先确认是不是 PSC 自动 DNS 故障

Private Service Connect(PSC)让应用通过所在私有网络的端点访问 Cloud SQL。同一数据库可供多个消费方 VPC 使用,各网络的端点地址可能不同。如果只有一个 VPC 报 DNS 找不到,先核定是哪个网络、哪个域名出问题,再决定修复范围。

用有权限的 Cloud SQL 实例详情或 gcloud sql instances describe INSTANCE_NAME 确认实际配置。实例专用域名对应某个实例,主库和各副本各有自己的名字。全局写入域名随当前主库切换,属于开启了相关功能和自动 DNS 的 Enterprise Plus 实例。诊断时记录应用用的是哪一种。

先查自动配置状态和前置条件

核对实例已启用 PSC 及自动 DNS,Cloud DNS API 已启用,且至少有一个 PSC 自动连接。再确认故障网络的服务连接策略存在。Google 文档把 Cloud DNS API 未启用、策略缺失、后台创建记录出错列为自动配置失败的常见起点。

在实例详情的 pscAutoConnections 中找到该 VPC,再读 instanceAutoDnsStatus。若应用使用全局写入域名,也查 writeEndpointAutoDnsStatus。保留错误状态和时间,并与能正常连接的 VPC 比较。假设测试网络正常、业务网络失败,从故障网络核对端点和解析结果更有用。

先对受影响网络执行标准修复

确认前置条件后,经授权执行 gcloud sql instances reconcile-networking INSTANCE_NAME --psc-dns。它会尝试恢复有问题的自动 DNS。Google 文档把标准修复列为不中断现有正常部分的方式,应用仍应在操作后验证。

只需处理某个消费方网络时,加上 --networks=projects/CONSUMER_PROJECT_ID/global/networks/CONSUMER_NETWORK_NAME,其中项目 ID 是承载该 VPC 的项目。省略 --networks 时,官方说明实例关联的所有消费方网络都在写入端点 DNS 重建范围内。先核对实例项目、消费方项目和网络名,避免把单网故障扩大到多网。

标准修复无效时再评估强制修复

加入 --force 后,Cloud SQL 会尝试恢复全部自动 DNS 设置,已正常运行的自动 DNS 部分可能短暂中断。先核对标准修复为什么没有成功,并记录当前端点和域名状态。在团队批准的窗口内处理,按实际业务安排验证。

使用 Cloud SQL Admin API 的团队可在 reconcileNetworking 请求的 pscDns 中明确设置 force,并按需传入 networks 数组。force 设为 false 对应标准修复,设为 true 对应强制修复。具体项目权限和通知按团队现有流程核对。

从原故障网络验收新连接

查看新的自动 DNS 状态,从原来报错的 VPC 解析应用实际使用的域名,并把返回的地址与该网络的实际 PSC 端点对照。一个 VPC 的成功不能代表另一处。使用 Cloud SQL Auth Proxy 或连接器时,从应用本来的运行环境验证 DNS 和连接。

临时故障恢复后,用经授权的应用或数据库连接作一次新建连接验证,记录成功的网络、域名和时间。若 DNS 已正确解析但依然连不上,继续查网络路径、数据库身份、授权和应用连接配置。仍无法解析自定义域名时,核对其 CNAME 及目标记录。

资料来源

常见问题

手工维护的私有 DNS 记录也会自动修好吗?

命令针对 PSC 自动 DNS。手工维护的区域、记录或自定义 CNAME 要按各自配置核对,尤其要验证应用所在 VPC 能读取相应记录。

哪个项目 ID 应填在 --networks 里?

填写消费方 VPC 所在的项目 ID。实例名称则在 Cloud SQL 实例所属项目的上下文中选择,两个项目可能不同。