迁移Spring Web至Spring Boot 1.5.13：多EntityManager注入WebMvcAutoConfiguration问题

我来帮你搞定这个Spring Boot迁移的问题，结合你提出的「不改内部库XML、保留双运行模式、多环境数据源切换」这些核心需求，给你一套可行的解决方案：

你遇到的错误本质是Spring Boot的WebMvc自动配置需要一个唯一的EntityManagerFactory候选bean，但类路径里有3个来自XML的实例，导致注入歧义。咱们可以通过包装已有bean并标记@Primary的方式解决，完全不用碰内部库的XML：

创建一个Spring配置类，先导入所有内部库的XML配置，然后用@Qualifier指定其中一个EntityManagerFactory作为默认，包装成带@Primary的bean：

@Configuration
// 替换成你实际的内部库XML路径，多个的话用逗号分隔
@ImportResource({"classpath:lib1-jpa-config.xml", "classpath:lib2-jpa-config.xml", "classpath:lib3-jpa-config.xml"})
public class PrimaryJpaConfig {

    // 把这里的"jpa-lib1-name1"换成你想设为默认的那个EntityManagerFactory的bean名称
    @Primary
    @Bean
    public EntityManagerFactory primaryEntityManagerFactory(
        @Qualifier("jpa-lib1-name1") EntityManagerFactory targetEmf
    ) {
        return targetEmf;
    }
}

这样既保留了内部库XML的原有配置逻辑，又给Spring明确指定了默认的EntityManagerFactory，WebMvcAutoConfiguration就能正常注入了。

利用Spring Boot的Profile机制来做环境隔离，同样不用改XML：

开发环境配置 #

在application-dev.properties里定义你的自定义数据源：

spring.datasource.url=jdbc:mysql://localhost:3306/your-dev-db
spring.datasource.username=dev-user
spring.datasource.password=dev-pass
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

再写一个仅在dev Profile下生效的配置类，把自定义数据源标记为@Primary——这样内部库的EntityManagerFactory会自动优先使用这个自定义数据源：

@Configuration
@Profile("dev")
public class DevDataSourceConfig {

    @Primary
    @Bean
    @ConfigurationProperties(prefix = "spring.datasource")
    public DataSource devDataSource() {
        return DataSourceBuilder.create().build();
    }
}

其他环境配置 #

在非开发环境（比如生产、测试），只要不激活dev Profile，Spring就会自动使用Tomcat容器提供的DataSource——因为没有自定义的@Primary数据源，内部库的XML配置会正常引用容器里的数据源。

你已经完成了WAR部署的配置，这里再确认下关键点：

• 启动类要继承SpringBootServletInitializer，并实现configure方法
• 打包时用Maven/Gradle的war插件，按需排除内嵌Tomcat（如果部署到外部Tomcat的话）

示例启动类：

@SpringBootApplication
public class YourApp extends SpringBootServletInitializer {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder app) {
        return app.sources(YourApp.class);
    }

    public static void main(String[] args) {
        SpringApplication.run(YourApp.class, args);
    }
}

这样应用既能通过main方法直接启动，也能打包成WAR部署到Tomcat。

• 一定要确认你在@Qualifier里写的bean名称和XML里定义的EntityManagerFactory名称完全一致
• 如果后续遇到多个JpaTransactionManager的歧义问题，用同样的包装方式给其中一个加@Primary就行
• 记得分别测试开发环境和生产环境的数据源切换，确保符合预期

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