@Primary是Spring Boot中解决多实现单注入冲突的默认选择机制，需加在@Component/@Service等组件类或@Bean方法上，同一类型仅允许一个，优先级低于@Qualifier。

@Primary 注解是 Spring Boot 中解决“多实现、单注入”冲突最直接的方式——它不改变 Bean 的定义数量，只告诉容器：“当没指名道姓要谁时，请默认选我”。设置默认 Bean 的关键不在写法多复杂，而在于理解它的触发条件和限制规则。

在哪加 @Primary 才生效

这个注解必须加在能被 Spring 容器识别为 Bean 的地方：

• 加在 @Component、@Service、@Repository 等组件类上（适用于包扫描场景）
• 加在 @Bean 方法上（适用于配置类中手动定义 Bean 的场景）
• 不能加在接口、抽象类或普通方法上，否则无效

只能有一个 @Primary

同一个类型下，Spring 不允许存在多个 @Primary 标记的 Bean。如果误加了两个，启动时会抛出异常：

NoSuchBeanDefinitionException 或 NoUniqueBeanDefinitionException（取决于上下文）

这不是警告，而是硬性校验。所以团队协作时建议在代码审查中检查该注解是否唯一。

Java调试

通过 JDWP 实现 Java 远程调试：连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。 术语注解 JDWP：Java Debug Wire Protocol，Java 调试有线协议（Java 远程调试底层通信协议） remote JVM：远程 Java 虚拟机 step through code：代码单步调试（步入 / 步过 / 步出调试） inspect variables：变量查看 / 变量检视 stac

下载

@Primary 和 @Qualifier 的关系

它们不是互斥的，而是分层配合：

• @Primary 是兜底策略：没加 @Qualifier 时自动生效
• @Qualifier 是显式指令：一旦写了 @Qualifier("xxx")，Spring 就忽略 @Primary，严格按名称匹配
• 优先级顺序明确：@Qualifier > @Primary

例如，即使 SmsService 只有 AliyunSmsService 标了 @Primary，你仍可在某处用 @Autowired @Qualifier("tencentSmsService") 主动选腾讯实现。

常见误用提醒

几个高频踩坑点：

• 加了 @Primary 却还是报 NoUniqueBeanDefinitionException？检查是否漏写了 @Service/@Component，导致类根本没注册成 Bean
• 在配置类里定义了两个同类型 @Bean，但都忘了加 @Primary？那依然会冲突——必须至少一个标上
• 以为 @Primary 能跨环境生效？它本身不感知 profile，如需按环境切换默认实现，应搭配 @ConditionalOnProperty 或 @Profile 使用