Spring MVC与JPA应用启动时加载data.sql失败问题求助

我之前也碰到过这个情况——Spring Boot会自动处理classpath下的data.sql，但纯Spring MVC环境没有这个自动配置，得手动加些配置才能让脚本生效。给你几个靠谱的方案：

方案一：用DataSourceInitializer执行脚本 #

直接在你的JpaConfig里添加一个DataSourceInitializer Bean，专门负责加载执行SQL脚本：

@Configuration 
@EnableTransactionManagement 
@EnableJpaRepositories(basePackages = {"com.egs.account.repository"}) 
@PropertySource(value = { "classpath:application.properties" }) 
public class JpaConfig { 
    @Autowired 
    private Environment env; 

    // 你的entityManagerFactory、dataSource等原有Bean...

    @Bean
    public DataSourceInitializer dataSourceInitializer(DataSource dataSource) {
        DataSourceInitializer initializer = new DataSourceInitializer();
        initializer.setDataSource(dataSource);
        
        ResourceDatabasePopulator populator = new ResourceDatabasePopulator();
        // 指定要加载的脚本文件
        populator.addScript(new ClassPathResource("data.sql"));
        // 可选：设置脚本编码，防止中文乱码
        populator.setSqlScriptEncoding("UTF-8");
        // 可选：脚本出错时是否继续执行（生产环境谨慎开启）
        populator.setContinueOnError(false);
        
        initializer.setDatabasePopulator(populator);
        return initializer;
    }
}

这个Bean会在Spring容器启动时自动执行指定的SQL脚本，逻辑直接清晰，适合大多数场景。

方案二：通过Hibernate配置加载脚本 #

如果你的JPA用的是Hibernate作为实现，可以在entityManagerFactory的配置里添加Hibernate专属属性：

@Bean(name = "entityManagerFactory") 
LocalContainerEntityManagerFactoryBean entityManagerFactory() { 
    LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
    em.setDataSource(dataSource());
    em.setPackagesToScan("com.egs.account.entity");

    HibernateJpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
    em.setJpaVendorAdapter(vendorAdapter);

    Properties properties = new Properties();
    properties.put("hibernate.dialect", env.getProperty("hibernate.dialect"));
    properties.put("hibernate.hbm2ddl.auto", env.getProperty("hibernate.hbm2ddl.auto"));
    // 添加这行指定要加载的SQL脚本，多个脚本用逗号分隔
    properties.put("hibernate.hbm2ddl.import_files", "classpath:data.sql");
    
    em.setJpaProperties(properties);
    return em;
}

注意：这个方法的执行时机是在Hibernate生成DDL之后，所以依赖于hibernate.hbm2ddl.auto的配置（比如create、create-drop），如果你的DDL是手动维护的，可能需要调整这个属性。

方案三：监听容器初始化事件执行脚本 #

如果需要更灵活的执行时机（比如等所有Bean都初始化完成后再执行），可以写一个监听器：

@Component
public class DataLoader implements ApplicationListener<ContextRefreshedEvent> {

    @Autowired
    private DataSource dataSource;

    @Override
    public void onApplicationEvent(ContextRefreshedEvent event) {
        // 防止容器刷新多次导致脚本重复执行
        if (event.getApplicationContext().getParent() == null) {
            try (Connection conn = dataSource.getConnection()) {
                ScriptUtils.executeSqlScript(conn, new ClassPathResource("data.sql"));
            } catch (SQLException e) {
                // 这里可以根据业务需求做异常处理，比如打日志、告警等
                e.printStackTrace();
            }
        }
    }
}

这种方式适合有特殊执行顺序要求的场景，比如需要依赖某些Bean初始化完成后再插入数据。

额外要注意的点 #

• 确认data.sql确实放在src/main/resources目录下，保证它在classpath里
• 检查数据库用户是否有执行脚本中SQL语句的权限（比如插入、更新操作的权限）
• 如果脚本里有特殊字符，一定要设置正确的编码，避免乱码问题

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