Spring Boot JUnit：如何在@BeforeEach中正确执行.sql文件的INSERT语句？

你遇到的问题是直接将文件路径当作SQL语句执行，而非读取文件内的SQL内容。以下是几种可行的解决方案：

方案1：使用ResourceLoader读取文件内容后执行 #

通过Spring的ResourceLoader加载classpath下的SQL文件，读取内容后再执行：

@SpringBootTest
class ClientServiceTest {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    @Autowired
    private ResourceLoader resourceLoader;

    @BeforeEach
    void setupDatabase() throws IOException {
        // 加载目标SQL文件
        Resource sqlResource = resourceLoader.getResource("classpath:sql/insertClient.sql");
        // 读取文件中的SQL内容
        String sqlContent = Files.readString(Paths.get(sqlResource.getURI()));
        // 执行SQL
        jdbcTemplate.execute(sqlContent);
    }

    // 测试方法实现...
}

注意：如果SQL文件包含多条语句，jdbcTemplate.execute()可能无法正确解析，此时推荐使用方案2。

方案2：用SqlScriptUtils执行SQL脚本（推荐） #

Spring提供的SqlScriptUtils可以自动处理多语句SQL、注释、语句分隔符等场景，更适合执行外部脚本：

@SpringBootTest
class ClientServiceTest {

    @Autowired
    private DataSource dataSource;

    @Autowired
    private ResourceLoader resourceLoader;

    @BeforeEach
    void setupDatabase() throws IOException, SQLException {
        Resource sqlResource = resourceLoader.getResource("classpath:sql/insertClient.sql");
        // 获取数据库连接并执行脚本
        try (Connection conn = dataSource.getConnection()) {
            SqlScriptUtils.executeSqlScript(conn, sqlResource);
        }
    }

    // 测试方法实现...
}

你还可以自定义脚本执行规则，比如指定语句分隔符、是否忽略错误：

SqlScriptUtils.executeSqlScript(
    conn, 
    sqlResource, 
    false,  // 是否继续执行错误
    true,   // 是否忽略注释
    ";",    // 语句分隔符
    "--",   // 单行注释前缀
    "/*",   // 多行注释开始标记
    "*/"    // 多行注释结束标记
);

方案3：使用@Sql注解简化配置（Spring Boot 2.2+） #

无需编写setupDatabase方法，直接通过@Sql注解指定SQL文件，Spring会自动在测试前执行脚本：

@SpringBootTest
@Sql("classpath:sql/insertClient.sql")  // 每个测试方法执行前自动运行该脚本
class ClientServiceTest {

    // 测试方法实现...
}

如果需要指定执行时机，可配置executionPhase：

@Sql(
    scripts = "classpath:sql/insertClient.sql",
    executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD
)

额外注意事项 #

• 检查SQL文件路径是否正确，你提到的inserClient.sql可能是笔误，应为insertClient.sql
• 确保SQL文件中的语句语法符合测试数据库的方言（如H2内存数据库的语法要求）
• 若使用内存数据库，需保证每次测试前数据库状态干净，避免数据污染

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