Go语言gRPC集成Prometheus时指标与服务调用异常问题

两个异常均由服务启动的阻塞逻辑导致：

1. 最初无法访问/metrics接口：仅注册了HTTP路由，没有启动HTTP监听服务，对应端口无进程响应HTTP请求。
2. 添加http.ListenAndServe(":8085", nil)后gRPC调用超时：http.ListenAndServe是阻塞式调用，如果该代码写在gRPC服务启动逻辑之前，会一直占用当前协程，后续gRPC服务的端口监听、启动逻辑完全不会执行，gRPC服务根本没有对外提供服务，客户端发起调用无法得到响应，最终触发DeadlineExceeded超时错误。

• 检查代码执行流：确认grpc.Server.Serve()的调用位置是否在http.ListenAndServe之后，阻塞式方法如果放在主协程靠前位置，会截断后续所有启动逻辑。
• 检查端口绑定：确认gRPC服务端口和metrics HTTP服务端口没有冲突，未做端口多路复用时两个服务不能绑定同一个端口。
• 检查拦截器链：确认prometheus拦截器之后没有其他自定义拦截器提前返回，阻断请求到业务逻辑的链路。

将metrics HTTP服务放到独立协程启动，避免阻塞gRPC服务的主启动流程：

package main

import (
	"context"
	"log"
	"net"
	"net/http"

	"github.com/grpc-ecosystem/go-grpc-prometheus"
	"github.com/prometheus/client_golang/prometheus/promhttp"
	"google.golang.org/grpc"
	// 替换为你自己的业务生成代码包路径
	"your/project/path/generatedfiles"
)

type RegisterFuncnService struct{}

// 实现你的业务服务对应接口方法
func (s *RegisterFuncnService) YourRpcMethod(ctx context.Context, req *generatedfiles.YourReq) (*generatedfiles.YourResp, error) {
	return &generatedfiles.YourResp{}, nil
}

func main() {
	// 初始化gRPC服务，注册prometheus拦截器
	grpcSrv := grpc.NewServer(
		grpc.StreamInterceptor(grpc_prometheus.StreamServerInterceptor),
		grpc.UnaryInterceptor(grpc_prometheus.UnaryServerInterceptor),
	)
	// 注册业务服务
	generatedfiles.RegisterFuncn(grpcSrv, &RegisterFuncnService{})
	// 注册gRPC指标采集器到prometheus
	grpc_prometheus.Register(grpcSrv)

	// 独立协程启动metrics HTTP服务，不阻塞主流程
	go func() {
		mux := http.NewServeMux()
		mux.Handle("/metrics", promhttp.Handler())
		log.Printf("metrics service start at :8085/metrics")
		if err := http.ListenAndServe(":8085", mux); err != nil {
			log.Fatalf("metrics service exit with error: %v", err)
		}
	}()

	// 主协程启动gRPC服务
	lis, err := net.Listen("tcp", ":50051") // 替换为你实际使用的gRPC端口
	if err != nil {
		log.Fatalf("gRPC listen port failed: %v", err)
	}
	log.Printf("gRPC service start at :50051")
	if err := grpcSrv.Serve(lis); err != nil {
		log.Fatalf("gRPC service exit with error: %v", err)
	}
}

• 不要使用全局默认的http.DefaultServeMux，自定义独立Mux注册metrics路由，避免第三方依赖自动注册未授权接口带来安全风险。
• 生产环境建议给metrics接口加内网访问限制、基础认证，避免指标数据泄露。
• 如果需要压缩端口占用，可以使用cmux做端口多路复用，在同一个端口上同时承载gRPC和HTTP流量，不需要单独为metrics服务开放端口。

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