Spring Boot中spring.sql.init.data-locations未遵循默认Schema配置问题咨询

这不是Spring Boot的Bug，是JPA（Hibernate）和SQL初始化组件的配置隔离导致的。

原因说明 #

• Hibernate的spring.jpa.properties.hibernate.default_schema是JPA层面的配置，仅作用于Hibernate生成和执行的JPA相关SQL（比如实体表创建、CRUD操作）。
• 而spring.sql.init.data-locations对应的SQL初始化模块，是直接基于数据源执行脚本的，它不会自动读取Hibernate的schema配置。如果数据源本身没指定默认schema，脚本就会在数据库的默认schema（比如PostgreSQL的public、MySQL的当前连接默认库）下执行，看起来像是“随机”的。

解决方案 #

1. 给数据源指定默认Schema

直接在数据源配置里设置默认schema，让SQL初始化模块和JPA共用同一个schema：

• 如果用JDBC URL：比如PostgreSQL可以加?currentSchema=myschema，MySQL可在URL后直接指定目标库；
• 如果用连接池（比如HikariCP）：添加配置spring.datasource.hikari.schema=myschema；
• 通用配置：部分数据库驱动支持spring.datasource.schema=myschema（具体视驱动而定）。

2. 在SQL脚本中动态注入Schema

利用Spring的占位符解析功能，把Hibernate的schema配置动态注入到init.sql中：

• 确保开启SQL初始化的占位符解析（默认已开启，可显式配置spring.sql.init.placeholder-enabled=true）；
• 在init.sql中用占位符引用配置：

  CREATE FUNCTION ${spring.jpa.properties.hibernate.default_schema}.my_function() 
  RETURNS INT 
  LANGUAGE plpgsql
  AS $$
  BEGIN
      -- 函数逻辑
      RETURN 1;
  END;
  $$;
  

• 注意：不同数据库的函数创建语法可能有差异，按需调整占位符位置即可。

3. 自定义SQL初始化逻辑

如果上面的方法不适用，可以手动编写代码执行脚本，主动读取Hibernate的schema配置：

@Component
public class CustomSqlInitializer {
    private final JdbcTemplate jdbcTemplate;
    private final Environment environment;

    public CustomSqlInitializer(JdbcTemplate jdbcTemplate, Environment environment) {
        this.jdbcTemplate = jdbcTemplate;
        this.environment = environment;
    }

    @PostConstruct
    public void initSql() throws IOException {
        String defaultSchema = environment.getProperty("spring.jpa.properties.hibernate.default_schema");
        // 读取init.sql内容
        String sqlScript = Files.readString(ResourceUtils.getFile("classpath:fixtures/init.sql").toPath());
        // 替换脚本中的自定义占位符（比如用{{schema}}作为标记）
        sqlScript = sqlScript.replace("{{schema}}", defaultSchema);
        // 执行脚本
        jdbcTemplate.execute(sqlScript);
    }
}

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