在 java 单元测试中,@sql 注解通过 spring testcontext 框架自动加载 sql 脚本。默认情况下,spring 会扫描类路径下与测试类同名的 sql 文件,或者根据 @sql 的 scripts 属性指定的相对或绝对路径加载。执行顺序遵循从类级别到方法级别的声明顺序,且默认在事务回滚前执行,确保测试数据隔离。

@Sql 注解如何指定脚本路径
可以通过 scripts 属性显式指定 SQL 文件的路径。支持 classpath: 前缀加载类路径资源,也支持 file: 前缀加载文件系统绝对路径。若未指定路径,Spring 会尝试使用默认的命名约定,即 /test.sql 或 /<classname>-test.sql</classname>。

import org.junit.jupiter.api.Test;
import org.springframework.test.context.jdbc.Sql;
@Sql("/data/setup.sql")
public class UserServiceTest {
@Test
@Sql("/data/cleanup.sql")
public void testUserCreation() {
// 测试逻辑
}
}
@Sql 注解的执行时机与事务管理
@Sql 脚本通常在测试方法执行前加载并执行。如果测试类或方法上配置了 @Transactional,SQL 脚本将在事务内执行,并在测试结束后自动回滚,保证数据库状态不被污染。若需持久化数据,可设置 executionPhase = Sql.ExecutionPhase.AFTER_TEST_METHOD 或在脚本后提交事务。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
立即学习“Java免费学习笔记(深入)”;

import org.junit.jupiter.api.Test;
import org.springframework.test.annotation.DirtiesContext;
import org.springframework.test.context.jdbc.Sql;
import org.springframework.transaction.annotation.Transactional;
@Transactional
@Sql(scripts = "/data/init.sql", executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
public class OrderServiceTest {
@Test
public void testOrderProcess() {
// 此时 init.sql 已执行且在事务中
}
}
当 SQL 脚本包含中文注释时如何处理编码问题
如果 SQL 脚本中包含中文注释或中文内容,必须确保文件编码为 UTF-8,并在 @SqlConfig 中明确指定 encoding = "UTF-8"。否则,Spring 可能因默认编码不一致导致解析失败或乱码,进而引发 SQL 语法错误。

















