Quarkus项目中解决Named Bean导致的AmbiguousResolutionException问题

在Quarkus 3.x版本升级过程中，开发者可能会遇到一个典型的依赖注入问题：当使用@Named注解为同一接口创建多个具名Bean时，系统会抛出AmbiguousResolutionException异常。这种情况特别容易出现在需要为不同区域（如欧洲和北美）创建相同REST客户端但配置不同的场景中。

问题本质分析

问题的核心在于CDI规范对默认限定符(@Default)的处理机制。当开发者使用@Named("beanA")和@Named("beanB")为同一接口创建多个实现时，这些Bean实际上都隐式带有@Default限定符。此时如果存在无明确限定符的注入点，容器会发现多个符合条件的Bean，从而抛出歧义异常。

在Quarkus的运行时环境中，RESTEasy Reactive扩展会自动创建某些默认的注入点，这些注入点往往不带任何限定符。这正是导致问题的直接原因——系统试图注入一个"默认"的FbaInboundV2024Api实例，但却发现了两个符合条件的候选Bean。

解决方案演进

方案一：自定义限定符（推荐）

最佳实践是避免使用@Named作为业务区分，转而采用类型安全的自定义限定符：

@Qualifier
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD, ElementType.METHOD, ElementType.TYPE, ElementType.PARAMETER})
public @interface RegionQualified {
    AmazonRegion value();
}

使用时可以明确指定区域：

@Produces
@ApplicationScoped
@RegionQualified(AmazonRegion.EU)
public FbaInboundV2024Api createEuClient() {
    // 创建欧洲区域客户端
}

这种方案的优势在于：

1. 完全类型安全，编译器可以检查
2. 消除了字符串硬编码带来的风险
3. 与CDI规范最佳实践一致

方案二：明确注入点限定

如果必须保留@Named方式，需要在所有注入点明确指定名称：

@Inject @Named("FbaInboundV2024ApiEu")
FbaInboundV2024Api euClient;

深入理解Quarkus行为变化

Quarkus 3.x版本对Bean处理机制进行了优化，主要表现在：

1. 更严格的Bean验证：启动时会检查所有可能的注入点
2. 延迟初始化策略变化：需要显式标记"不可移除"的Bean
3. 对REST客户端的处理更加规范

这些变化虽然提高了运行时效率，但也要求开发者更严格地遵循CDI规范。特别是对于跨模块的Bean定义，需要特别注意可见性和限定符的使用。

最佳实践建议

1. 优先使用类型安全的自定义限定符而非@Named
2. 对于跨模块的Bean，明确其可见性范围
3. 在Quarkus 3.x中，需要显式标记运行时需要的Bean为Unremovable
4. 考虑使用接口继承而非同一接口多实现来区分不同场景
5. 对于REST客户端，可以利用配置映射而非编程式创建

通过采用这些策略，开发者可以构建出更加健壮、易于维护的Quarkus应用，同时避免依赖注入相关的运行时异常。