Spring Boot 依赖注入命名应语义化、业务导向，优先使用默认驼峰名，多实现时用@Qualifier配合显式命名如"wechatNotifier"，避免冗余后缀；@Bean方法名即ID，需清晰体现职责。
Spring Boot 本身不强制规定依赖注入的命名规范，但命名是否合理直接影响可读性、可维护性与注入准确性——尤其在多实现、泛型或复杂 Bean 场景下。规范的核心目标是：让 Spring 能准确匹配 Bean，让人一眼看懂“注入的是谁、为什么是它”。
Bean 名称默认规则（自动推导）
Spring 会为每个 @Component、@Service、@Repository、@Controller 等注解类生成一个默认 Bean 名称：
- 首字母小写的类名（驼峰命名法）：如
UserServiceImpl→ 默认 Bean 名为userServiceImpl - 若类名以两个大写字母开头（如
XMLParser），则默认名称保持全小写：xmlParser（符合 JavaBeans 规范） - 接口实现类若未显式指定名称，就依赖这个默认名；字段注入或构造器注入时，Spring 先按类型找，类型不唯一时再按这个默认名匹配
显式命名：用 @Component("xxx") 或 @Service("xxx")
当存在多个同类型实现，或默认名语义不清时，必须显式命名。推荐使用**语义化、业务导向的名称**，而非技术后缀：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- ✅ 推荐：
@Service("wechatNotifier")、@Repository("mysqlUserRepo")、@Component("v2OrderValidator") - ❌ 避免：
@Service("userServiceImpl")（冗余，默认已有）、@Component("notifierImpl")（无区分度） - 命名建议全部小写，用英文单词或缩写，单词间用驼峰或短横线（Spring 原生支持短横线，如
"sms-notifier"，但需配合@Qualifier("sms-notifier")使用）
配合 @Qualifier 精准绑定
当类型相同但实现不同（如多种通知方式、多种数据源），@Qualifier 是命名规范落地的关键环节：
- 在实现类上标注语义化
@Qualifier("email")、@Qualifier("aliyunOss") - 注入处用
@Autowired @Qualifier("email") private Notifier notifier; - 避免只靠
@Primary“硬指定”——它掩盖了多实现意图，不利于扩展和测试 - 泛型场景（如
Mapper<User, UserDto>）必须搭配@Qualifier，否则因类型擦除导致注入失败
配置类中 @Bean 方法的命名
@Bean 方法名即为该 Bean 的 ID（除非用 @Bean("customName") 显式覆盖）。因此方法名应直接体现其职责：
- ✅ 清晰：
@Bean public RedisTemplate<String, Object> userCacheTemplate() { ... } - ✅ 区分环境：
@Bean @Profile("prod") public DataSource primaryDataSource() { ... } - ❌ 模糊：
@Bean public RedisTemplate redisTemplate() { ... }（多个 RedisTemplate 时无法区分）
命名不是越长越好，而是要让“谁在用、为什么用、用的是哪一个”一目了然。一套统一、语义优先、与业务对齐的命名习惯，比任何工具都更能防止注入歧义和运行时异常。
