Go调用Vertex AI Vector Search接口报错排查求助

• 显式配置gRPC dial选项禁用TLS
  Vertex AI匹配引擎的内部PSA端点使用明文gRPC通信，Go SDK默认启用TLS加密，这会导致连接失败。初始化客户端时必须添加自定义dial选项禁用TLS：

  import (
      "context"
      "cloud.google.com/go/aiplatform/apiv1/aiplatformpb"
      "google.golang.org/api/option"
      "google.golang.org/grpc"
      "google.golang.org/grpc/credentials/insecure"
  )
  
  func createMatchEngineClient() (aiplatformpb.MatchEngineServiceClient, error) {
      opts := []option.ClientOption{
          option.WithEndpoint("10.25.0.5:10000"),
          option.WithGRPCDialOption(grpc.WithTransportCredentials(insecure.NewCredentials())),
      }
      return aiplatformpb.NewMatchEngineServiceClient(context.Background(), opts...)
  }
  

  必须使用insecure.NewCredentials()禁用TLS，否则gRPC会尝试建立加密连接，内部端点不支持该方式，直接导致连接被拒绝。

• 确认程序运行环境的网络可达性
  确保运行Go程序的环境（如GCE实例、Cloud Run服务、本地机器）与匹配引擎所在VPC网络连通：

  • GCP内部资源需处于同一VPC，或已配置VPC peering、Cloud VPN/Cloud Interconnect。
  • 本地测试需通过Cloud VPN或专用通道接入目标VPC，公网无法直接访问内部PSA端点。
    在运行环境执行nc -zv 10.25.0.5 10000验证网络连通性，确保端口可正常访问。

• 检查端点参数正确性
  核对GCP控制台中匹配引擎索引的"私有服务访问端点"信息，确保使用的IP和端口（默认10000）完全一致，避免添加https://或grpc://前缀，直接使用IP:端口格式。

• 验证SDK版本兼容性
  尝试升级cloud.google.com/go/aiplatform SDK到最新稳定版本，旧版本可能存在内部端点处理的bug：

  go get cloud.google.com/go/aiplatform@latest
  

  升级后重新测试连接，确认问题是否解决。

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