Schema Registry Maven插件：未注册Subject的test-compatibility执行问题

核心结论：无法直接对Schema Registry中未注册的Subject执行schema-registry:test-compatibility目标。

原因分析 #

schema-registry:test-compatibility Maven插件的设计逻辑依赖Schema Registry中已存在的Subject历史版本完成兼容性校验。对于Protobuf schema而言，插件解析时会自动处理跨Subject的引用关系，这一步会向Registry发起请求获取引用Subject的元数据——从你提供的堆栈日志能看到，错误就发生在resolveReferences方法调用阶段，Registry返回404，因为目标Subject未注册。

错误核心信息：

io.confluent.kafka.schemaregistry.client.rest.exceptions.RestClientException: Subject '[SUBJECT NAME].proto' not found.; error code: 40401

适配CI流水线的解决方案 #

由于你需要将兼容性校验加入CI流水线且无法使用schema-registry:test-local-compatibility，可参考以下两种方案：

1. CI环境临时部署Schema Registry并预注册初始版本 #

在CI流水线中新增步骤：

• 启动临时Schema Registry实例（比如用Docker容器，CI运行时创建，结束后销毁）
• 先执行schema-registry:register目标，将待校验Subject的初始版本（或需要兼容的历史版本）注册到临时Registry
• 再执行schema-registry:test-compatibility目标完成校验

这种方式完全模拟生产环境的Registry校验逻辑，且不会污染正式环境的Registry数据。

2. 直接调用Schema Registry兼容性校验API #

跳过Maven插件，直接调用Registry的REST API完成校验：

• 若校验"该schema能否作为Subject的第一个版本"，可执行：

  curl -X POST \
    http://<ci-registry-url>/compatibility/subjects/<subject-name>/versions \
    -H "Content-Type: application/vnd.schemaregistry.v1+json" \
    -d '{
      "schema": "<你的Protobuf schema内容>",
      "schemaType": "PROTOBUF",
      "compatibility": "BACKWARD" # 按需指定兼容性模式（如FORWARD、FULL等）
    }'
  

• 若需校验新schema与旧版本的兼容性，先调用注册API将旧版本注册到临时Registry，再执行上述兼容性校验请求。

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