在项目VPC网络中创建Cloud SQL实例遇错求助

核心原因 #

出现NETWORK_NOT_PEERED错误是因为Cloud SQL服务需要与你的VPC建立对等连接才能提供私有IP访问，非共享VPC默认不会自动创建这个连接，必须先配置私有服务访问（Private Service Access）。

步骤1：配置私有服务访问 #

1. 选择一个未被当前VPC子网占用的CIDR段（例如10.100.0.0/24，务必确保和现有子网无重叠）
2. 运行命令建立服务与VPC的对等连接：

gcloud services vpc-peerings connect \
    --service=servicenetworking.googleapis.com \
    --ranges=你的CIDR段 \
    --network=你的VPC网络名 \
    --project=你的项目ID

执行成功后，等待1-2分钟让对等连接生效。

步骤2：创建私有IP Cloud SQL实例 #

使用以下命令创建仅带私有IP的实例（以MySQL为例，可替换为对应数据库版本）：

gcloud sql instances create 实例名称 \
    --database-version=MYSQL_8_0 \
    --region=你的目标区域 \
    --no-assign-ip \
    --network=你的VPC网络名 \
    --project=你的项目ID

• --no-assign-ip：强制禁用公网IP，满足组织限制
• --network：指定已配置对等连接的VPC网络

验证实例状态 #

创建完成后，可通过以下命令确认私有IP已配置：

gcloud sql instances describe 实例名称 --project=你的项目ID | grep privateIpAddress

注意事项 #

• 若CIDR段与现有子网重叠，会导致对等连接创建失败，需重新选择可用的CIDR
• 如果VPC有自定义防火墙规则，需确保允许VPC内资源与Cloud SQL实例的通信（私有服务访问默认会配置基础允许规则）

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