在 quarkus 自定义扩展中，若需根据构建时属性（如 `myproperty=true`）条件性注册 bean，仅对 `@ifbuildproperty` 注解生效的前提是：这些 bean 必须被 cdi 容器识别为可扫描的候选组件——最简方案是在运行时模块的 `src/main/resources/meta-inf/` 下添加空的 `beans.xml` 文件。
@IfBuildProperty 是 Quarkus 提供的关键条件注解，用于控制 Bean 在构建阶段是否被注册到 CDI 容器中。但其生效有一个隐式前提：目标类必须属于 CDI 扫描范围。而 Quarkus 扩展的运行时模块（runtime module）默认不启用 CDI 扫描——即使你在类上标注了 @ApplicationScoped 或 @IfBuildProperty，若缺少 META-INF/beans.xml，Quarkus 构建器会直接忽略这些类，导致条件注解失效，AdditionalBeanBuildItem 也会“强行注入”未经条件校验的 Bean。
✅ 正确做法（推荐）：
在扩展的 runtime 模块（即包含实际 Bean 类的模块）的 src/main/resources/META-INF/ 目录下，创建一个空的 beans.xml 文件：
<!-- src/main/resources/META-INF/beans.xml -->
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="https://jakarta.ee/xml/ns/jakartaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/beans_4_0.xsd"
version="4.0" bean-discovery-mode="all">
</beans>? 注意：bean-discovery-mode="all" 显式启用全量扫描（兼容 Quarkus 2.13+），也可简化为最小化空文件（仅 ），Quarkus 会自动识别为启用扫描模式。
随后，在你的可选能力 Bean 上正确使用条件注解：
@ApplicationScoped
@IfBuildProperty(name = "my-extension.feature.enabled", stringValue = "true")
public class OptionalFeatureService {
public void doSomething() { /* ... */ }
}并在 application.properties 中按需启用：
my-extension.feature.enabled=true # → Bean 注册 # 或完全不配置 / 设为 false → Bean 被跳过
⚠️ 补充说明：
- 不要依赖 AdditionalBeanBuildItem 绕过条件逻辑——它会强制注册 Bean，使 @IfBuildProperty 失效；应让 Quarkus 自动发现并由条件注解驱动注册流程。
- 若需更复杂逻辑（如基于多个属性组合、或运行时值判断），可改用 @Consume + BuildStep 配合 ConditionalBeanBuildItem，但对单属性开关场景，@IfBuildProperty + beans.xml 是最轻量、最符合 Quarkus 约定的方式。
- 验证是否生效：构建后检查 target/quarkus-app/app/ 下的 quarkus-component-info.dat，或启用 -Dquarkus.log.category."io.quarkus.arc".level=DEBUG 查看 ARC 日志中的 Bean 匹配详情。
遵循此模式，你的扩展即可实现真正“按需构建”的能力，既保持简洁性，又完全兼容 Quarkus 的构建时优化机制。
