Spring Boot多控制器使用及启动Bean名称冲突报错问题

这个问题我之前踩过坑！核心原因很简单：Spring默认会把类名首字母小写作为bean的默认名称，所以你两个不同包下的UserController类，都会被自动命名为userController，这不就撞车了嘛😅。给你几个实用的解决办法：

方法一：手动指定唯一的Bean名称 #

直接在@Controller（或@RestController）注解里通过value属性给每个控制器分配独一无二的名称，跳过Spring的默认命名规则。示例代码：

// com.xyz.a.UserController
@Controller("backendUserController")
public class UserController {
    // 你的业务代码
}

// com.xyz.b.UserController
@Controller("frontendUserController")
public class UserController {
    // 你的业务代码
}

这种方式灵活，不需要调整类结构，适合不想改类名的场景。

方法二：全局自定义Bean命名策略 #

如果项目里有大量同名类的情况，可以配置一个全局的Bean命名生成器，让它把包名也纳入Bean名称的组成部分，从根源避免冲突。

首先实现BeanNameGenerator接口：

public class PackageAwareBeanNameGenerator implements BeanNameGenerator {
    @Override
    public String generateBeanName(BeanDefinition definition, BeanDefinitionRegistry registry) {
        String fullClassName = definition.getBeanClassName();
        // 将完整类名的点号替换掉，生成带包名前缀的Bean名称
        return fullClassName.replace(".", "_");
    }
}

然后在启动类的@ComponentScan注解里指定这个生成器：

@SpringBootApplication
@ComponentScan(nameGenerator = PackageAwareBeanNameGenerator.class)
public class UserIntegrationServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(UserIntegrationServiceApplication.class, args);
    }
}

这样两个控制器的Bean名称会变成com_xyz_a_UserController和com_xyz_b_UserController，彻底解决冲突。

方法三：修改控制器类名（最省心方案） #

如果业务上允许，直接给其中一个控制器改个独特的类名，比如一个叫AdminUserController，另一个叫AppUserController。这样Spring生成的默认Bean名称adminUserController和appUserController自然不会重复。虽然简单，但要保证类名符合业务语义哦。

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