You need to enable JavaScript to run this app. Terraform创建GCP CloudSQL报SERVICE_NETWORKING_NOT_ENABLED排查
优惠活动
大模型
产品
解决方案
定价
更多

Terraform创建GCP CloudSQL报SERVICE_NETWORKING_NOT_ENABLED排查

错误根因说明

这个SERVICE_NETWORKING_NOT_ENABLED报错和Cloud SQL实例本身的IP配置语法无关,核心触发逻辑是:只要在Cloud SQL的ip_configuration块中填写了private_network参数,不管你是否实际启用私有IP访问,GCP都会强制校验你指定的VPC是否完成了服务联网的前置配置,未完成就直接抛出对应错误,不会因为你只开公网IP就跳过校验。
你之前的正常运行实例大概率是在控制台手动完成了这些前置配置,但Terraform代码中完全没有把这些依赖资源纳入管理范围,所以新部署时会因为前置条件缺失直接失败。

当前配置缺失的必备配套资源

因为你使用的是归属于gcp-backend项目的跨项目VPC,所有服务联网配置都需要落到VPC所属的项目下,不能仅在Cloud SQL托管的主项目操作,缺的资源分别是:

  • 目标VPC所属项目的基础API启用:需要在gcp-backend项目开启servicenetworking.googleapis.com服务API。你当前的depends_on仅关联了主项目的服务启用流程,完全没有覆盖二级项目的API开通步骤,这是触发报错的最常见原因。
  • 私有服务访问的预留IP范围:需要在gcp-backend项目的目标VPC中,创建一块供GCP私有服务(包含Cloud SQL)预留的内部IP地址段,要求网段不能和VPC内现有路由、子网CIDR冲突。对应的Terraform资源为google_compute_global_address,示例配置:
# 需提前配置对应二级项目的provider凭证,不能复用主项目的默认provider
resource "google_compute_global_address" "cloudsql_private_range" {
  provider      = google.backend_project
  name          = "cloudsql-reserved-range"
  project       = "gcp-backend"
  purpose       = "VPC_PEERING"
  address_type  = "INTERNAL"
  prefix_length  = 16
  network       = "projects/gcp-backend/global/networks/default"
}
  • 服务联网的VPC对等连接配置:把上一步创建的预留IP范围和GCP的Service Networking服务建立peering连接,这就是报错提示的“未启用的服务联网配置”。对应的Terraform资源为google_service_networking_connection,示例配置:
resource "google_service_networking_connection" "vpc_private_service_connection" {
  provider                = google.backend_project
  network                 = google_compute_global_address.cloudsql_private_range.network
  service                 = "servicenetworking.googleapis.com"
  reserved_peering_ranges = [google_compute_global_address.cloudsql_private_range.name]
}
现有配置需要调整的细节
  • 修正资源创建的依赖关系:给google_sql_database_instance资源的depends_on列表增加google_service_networking_connection.vpc_private_service_connection,避免Terraform并行执行时出现“网络连接还未就绪就开始创建Cloud SQL实例”的时序错误。
  • 修正参数类型:你当前配置中所有布尔类型参数都额外加了引号(比如ipv4_enabled = "true"、binary_log_enabled = "true"),虽然部分版本的provider会做隐式类型转换,但建议改成不带引号的布尔值true/false,避免后续出现随机的配置校验失败问题。
  • 跨项目权限校验:确认Cloud SQL所在主项目的内置服务账号,在gcp-backend项目下拥有目标VPC的Compute Network User、Service Networking Admin角色权限,否则即使完成了上述配置,也会因为跨项目权限不足无法完成网络关联。
  • 确认private_network参数的格式正确:你当前填写的projects/gcp-backend/global/networks/default是符合要求的全限定VPC路径,不需要额外填写子网信息——Cloud SQL的私有网络关联是VPC级别的peering连接,和VPC下的具体子网没有绑定关系,填错成子网路径反而会触发新的报错。

内容的提问来源于stack exchange,提问作者NealR

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 11:06:03