如何在Helidon MP项目级beans.xml配置Stereotype并让依赖项目识别？

你遇到的核心问题是CDI规范中beans.xml的配置是模块独立的：项目A/B的beans.xml里的<stereotypes>配置仅对当前项目模块内的Bean生效，无法传递到依赖Jar模块。依赖Jar中的Bean不会感知到项目级的Stereotype激活配置，导致带有对应Stereotype的适配Bean未被实例化，最终抛出WELD-001408依赖不满足异常。

下面提供两种无需修改依赖Jar的beans.xml、仅在项目级配置即可实现需求的方案：

方案一：使用@Alternative + 项目级beans.xml激活 #

通过给依赖Jar中的适配Bean标记@Alternative，然后在项目级beans.xml中指定要激活的依赖Bean，直接控制实例化逻辑。

步骤1：定义Stereotype注解（可选，用于分类） #

@Stereotype
@Target(TYPE)
@Retention(RUNTIME)
public @interface ProjectA {}

@Stereotype
@Target(TYPE)
@Retention(RUNTIME)
public @interface ProjectB {}

步骤2：在依赖Jar中实现适配Bean #

给不同项目的适配Bean添加@Alternative和对应Stereotype：

// 共享服务接口
public interface SharedService {
    void execute();
}

// 适配项目A的实现
@ApplicationScoped
@Alternative
@ProjectA
public class ProjectAService implements SharedService {
    @Override
    public void execute() {
        // 项目A专属逻辑
    }
}

// 适配项目B的实现
@ApplicationScoped
@Alternative
@ProjectB
public class ProjectBService implements SharedService {
    @Override
    public void execute() {
        // 项目B专属逻辑
    }
}

步骤3：在项目级beans.xml中激活对应Bean #

在项目A的beans.xml中指定激活依赖Jar里的ProjectAService：

<beans xmlns="http://xmlns.jcp.org/xml/ns/javaee"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/beans_2_0.xsd"
       version="2.0" bean-discovery-mode="annotated">
    <alternatives>
        <!-- 填写依赖Jar中适配Bean的全类名 -->
        <class>com.your.shared.package.ProjectAService</class>
    </alternatives>
</beans>

项目B的beans.xml同理替换为ProjectBService的全类名即可。

方案二：使用条件激活（更灵活，无需修改beans.xml） #

利用Helidon MP的配置体系，结合CDI的@Conditional注解，根据项目配置参数动态激活对应Bean，完全不需要修改beans.xml。

步骤1：实现条件判断类 #

在依赖Jar中编写条件判断逻辑，根据项目配置参数决定是否激活Bean：

public class ProjectCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context) {
        // 获取Helidon全局配置
        Config config = ConfigProvider.getConfig();
        String projectType = config.get("project.type").asString().orElse("");
        
        // 根据Bean的Stereotype注解匹配配置
        AnnotatedType<?> beanType = context.getAnnotatedType();
        if (beanType.isAnnotationPresent(ProjectA.class)) {
            return "A".equals(projectType);
        }
        if (beanType.isAnnotationPresent(ProjectB.class)) {
            return "B".equals(projectType);
        }
        return false;
    }
}

步骤2：给依赖Jar的Bean添加条件注解 #

@ApplicationScoped
@ProjectA
@Conditional(ProjectCondition.class)
public class ProjectAService implements SharedService {
    // 项目A逻辑
}

@ApplicationScoped
@ProjectB
@Conditional(ProjectCondition.class)
public class ProjectBService implements SharedService {
    // 项目B逻辑
}

步骤3：在项目级配置文件中指定类型 #

项目A的application.yaml：

project:
  type: A

项目B的application.yaml：

project:
  type: B

启动项目时，Helidon会自动根据配置参数激活对应的适配Bean，无需修改任何beans.xml。

注意事项 #

1. 确保依赖Jar的beans.xml中bean-discovery-mode设置为annotated或all，保证Bean能被CDI容器发现。
2. 使用@Alternative方案时，要避免共享接口存在多个非@Alternative的实现，否则会引发Bean歧义。
3. 条件激活方案依赖Helidon MP的Config组件，这是Helidon的默认集成功能，无需额外引入依赖。

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