Quarkus运行时动态添加/移除REST端点的实现方案咨询

原生支持情况 #

Quarkus目前不原生支持运行时动态增删REST服务的能力。

Quarkus的设计核心围绕编译时优化展开，大部分REST端点会在应用启动阶段通过注解扫描、字节码增强等方式完成注册，运行阶段没有官方提供的标准API用于动态添加或移除端点。你提到的Issue#11966、#11415也明确了Quarkus不支持多Application实例，而单应用内的动态REST端点管理也未被纳入官方文档或RESTEasy的核心能力范畴。

自定义实现的切入点 #

如果需要实现该能力，可以从以下几个方向入手：

1. 基于RESTEasy Reactive的编程式路由注册 #

RESTEasy Reactive底层依赖Vert.x，允许直接操作Vertx和Router实例来动态添加端点：

• 注入Router和Vertx实例，通过router.get("/dynamic-path").handler(rc -> { ... })这类代码绑定新的请求处理逻辑；
• 若需要绑定传统的JAX-RS资源类，可以使用RoutingBuilder将资源类关联到路由；
• 注意处理并发安全问题，运行时修改路由需确保操作在Vert.x的事件循环线程中执行，避免线程冲突。

2. 结合CDI动态Bean管理（需配合编程式路由） #

如果你的REST服务基于CDI Bean，可以通过BeanManager动态注册或销毁Bean，但需注意：

• Quarkus启动后不会自动扫描新注册的CDI Bean作为REST端点，因此动态注册Bean后，仍需通过编程式路由将其绑定到请求路径；
• 原生镜像模式下，动态Bean的类型需要提前在reflect-config.json中配置，避免GraalVM编译时丢失相关元数据。

3. 直接操作Vert.x Router实现路由管理 #

由于Quarkus的REST层最终都映射到Vert.x Router，直接操作Router是最直接的方式：

• 注入Router实例后，可随时添加新的路由规则；
• Vert.x Router没有原生的路由移除API，因此需要自行维护动态路由的注册表，当需要移除时，可通过重新构建Router或使用自定义匹配条件过滤失效路由。

4. 编写Quarkus扩展封装能力 #

如果需要系统化的动态端点管理，可以编写自定义Quarkus扩展：

• 扩展可访问Quarkus运行时的核心组件，封装动态路由注册/移除的API；
• 可集成RESTEasy的内部注册机制，实现更贴近JAX-RS规范的动态端点管理。

注意事项 #

• 原生镜像适配：动态添加的代码、类需要在GraalVM编译时被正确识别，需补充反射、资源等配置；
• 性能影响：频繁的运行时路由修改可能带来性能损耗，需根据业务场景做测试评估；
• 跨实例同步：跨JVM迁移场景下，需自行实现中心配置的同步逻辑，触发各Quarkus实例执行端点增删操作。

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