Prometheus抓取/metrics端点报错expected label name, got "BCLOSE"

expected label name, got "BCLOSE" 报错和你两种/metrics接口的实现逻辑无关，两类序列化方式（TextFormat.write004、prometheusRegistry.scrape()）都只会原样输出Registry中存储的指标数据，不会对指标名、标签名做合法性校验。报错的核心原因是你注册到Prometheus Meter Registry中的某条指标使用了不符合Prometheus命名规范的标签名，Prometheus拉取到指标文本做语法解析时，在本该出现合法标签名的位置读到了"BCLOSE"字符串，直接抛出解析失败错误。

Prometheus对指标名、标签名有强制命名要求，必须匹配正则规则 [a-zA-Z_:][a-zA-Z0-9_:]*，即仅允许使用大小写字母、数字、下划线、冒号，且首字符不能为数字，一旦标签名包含空格、引号、大括号等特殊字符，或是将动态业务值误作为标签名传入，就会触发这类解析错误。

• 绕过Prometheus直接访问本地端点验证原始输出：执行 curl http://localhost:7070/metrics 拿到完整的指标文本，全局搜索BCLOSE关键字，直接定位到格式异常的具体指标行。
• 重点检查自定义埋点代码的传参顺序：Micrometer/Prometheus client的埋点方法传参格式为指标名, 标签键1, 标签值1, 标签键2, 标签值2...，非常容易出现把动态业务值误作为标签键传入的问题——标签键必须是固定的合法标识符，动态业务内容应该放在标签值位置。
• 如果是第三方组件自动注入的埋点，遍历Registry中所有指标打印标签名排查：可以在接口临时加遍历逻辑，打印所有指标的名称和关联标签键，快速定位非法项：

prometheusRegistry.getPrometheusRegistry().metricFamilySamples().forEachRemaining(sample -> {
    System.out.println("指标名: " + sample.name);
    sample.samples.forEach(s -> System.out.println("  标签键集合: " + s.labelNames));
});

你当前的两种接口实现还存在Content-Type设置错误的问题，虽然不是本次报错的根因，但后续可能引发内容协商失败：

• 第一种实现直接返回字符串时，JAX-RS默认的Content-Type不是Prometheus识别的指标格式，需要显式设置为 text/plain; version=0.0.4; charset=utf-8
• 第二种实现直接设置为application/openmetrics-text不符合普通Prometheus文本格式的要求，除非你明确输出的是OpenMetrics规范格式，否则不要用这个Content-Type。

修复完非法标签名之后，正确的接口实现可以参考：

@GET
@Path("/metrics")
public Response getMetrics() {
    return Response.ok(prometheusRegistry.scrape())
            .type("text/plain; version=0.0.4; charset=utf-8")
            .build();
}

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