使用Cloud SQL Auth Proxy连接仅私有IP的Cloud SQL实例失败求助

问题原因 #

你的Cloud SQL实例仅配置了私有IP，而默认情况下Cloud SQL Auth Proxy会尝试使用公网IP连接实例，因此触发"instance does not have IP of type 'PUBLIC'"错误。

解决步骤 #

在启动Cloud SQL Auth Proxy时添加--private-ip参数，强制代理使用私有IP连接实例：

./cloud-sql-proxy --run-connection-test --private-ip --credentials-file <file> <instance connection name>

额外注意事项 #

• 本地机器需能访问该VPC的私有IP段，可通过Cloud VPN、Cloud Interconnect建立连通；若用Cloud Shell连接，因属于GCP内部网络，可直接访问私有IP实例。
• 确认credentials-file对应的服务账号已拥有Cloud SQL Client角色权限，确保具备实例访问权限。

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