SQL存储过程的单元测试是保障数据库逻辑正确性的重要手段，很多开发者不清楚如何高效开展相关测试工作。tSQLt框架是SQL Server环境下常用的单元测试工具，能够帮助我们快速编写和运行存储过程的测试用例。
tSQLt框架简介与安装
tSQLt是一个基于SQL Server的单元测试框架，它完全运行在数据库内部，不需要额外的外部工具支持。它的核心优势是可以直接对存储过程、函数、视图等数据库对象进行测试，并且支持事务隔离，测试完成后会自动回滚，不会污染实际业务数据。
安装tSQLt框架的步骤如下：
- 下载tSQLt框架的安装包，解压后得到tSQLt.class.sql文件
- 在需要测试的数据库中执行该SQL文件，框架会自动创建对应的系统表和存储过程
- 执行以下语句验证安装是否成功：
-- 验证tSQLt是否安装成功 EXEC tSQLt.RunAll;
测试用例编写基本规则
使用tSQLt编写测试用例需要遵循固定的结构，所有的测试存储过程都需要放在以tSQLt.TestClass标记的类（本质是SQL Server的schema）中，测试方法的命名需要以test开头。
创建测试类
首先需要创建一个测试类，用于存放所有的测试用例：
-- 创建测试类，命名为MyStoredProcedureTests EXEC tSQLt.NewTestClass 'MyStoredProcedureTests';
编写单个测试用例的结构
一个完整的测试用例通常包含三个部分：准备测试数据、执行被测存储过程、断言结果是否符合预期。tSQLt提供了多个断言存储过程，常用的包括tSQLt.AssertEquals、tSQLt.AssertEqualsTable、tSQLt.AssertEmptyTable等。
实际存储过程测试示例
假设我们有一个存储过程usp_GetUserCountByStatus，用于根据用户的启用状态统计用户数量，存储过程定义如下：
-- 被测存储过程：根据用户启用状态统计用户数量
CREATE PROCEDURE usp_GetUserCountByStatus
@IsEnabled BIT, -- 用户是否启用，1为启用，0为禁用
@UserCount INT OUTPUT -- 输出用户数量
AS
BEGIN
SET NOCOUNT ON;
SELECT @UserCount = COUNT(1)
FROM Users
WHERE IsEnabled = @IsEnabled;
END
接下来我们为这个存储过程编写测试用例，测试场景为：当查询启用用户数量时，返回的结果与预期一致。
-- 测试用例：测试启用用户数量统计
CREATE PROCEDURE MyStoredProcedureTests.test_EnabledUserCountIsCorrect
AS
BEGIN
-- 1. 准备测试数据：创建临时测试表，插入测试数据
EXEC tSQLt.FakeTable 'Users'; -- 伪造Users表，避免操作实际业务表
INSERT INTO Users (Id, UserName, IsEnabled)
VALUES
(1, '张三', 1),
(2, '李四', 1),
(3, '王五', 0);
-- 2. 执行被测存储过程
DECLARE @ActualCount INT;
EXEC usp_GetUserCountByStatus
@IsEnabled = 1,
@UserCount = @ActualCount OUTPUT;
-- 3. 断言结果：预期启用用户数量为2
DECLARE @ExpectedCount INT = 2;
EXEC tSQLt.AssertEquals @ExpectedCount, @ActualCount, '启用用户数量统计错误';
END
如果需要测试存储过程返回的表数据，可以使用tSQLt.AssertEqualsTable来对比预期表和实际结果表，示例如下：
-- 测试用例：测试返回的用户列表是否正确
CREATE PROCEDURE MyStoredProcedureTests.test_UserListByStatusIsCorrect
AS
BEGIN
-- 准备测试数据
EXEC tSQLt.FakeTable 'Users';
INSERT INTO Users (Id, UserName, IsEnabled)
VALUES
(1, '张三', 1),
(2, '李四', 1),
(3, '王五', 0);
-- 创建预期结果表
CREATE TABLE #ExpectedUsers (Id INT, UserName NVARCHAR(50));
INSERT INTO #ExpectedUsers VALUES (1, '张三'), (2, '李四');
-- 创建实际结果表，执行存储过程插入结果
CREATE TABLE #ActualUsers (Id INT, UserName NVARCHAR(50));
INSERT INTO #ActualUsers
EXEC usp_GetEnabledUsers; -- 假设存在返回启用用户列表的存储过程
-- 断言两个表数据一致
EXEC tSQLt.AssertEqualsTable '#ExpectedUsers', '#ActualUsers', '启用用户列表返回错误';
END
运行测试用例与查看结果
编写完成测试用例后，可以通过以下方式运行测试：
- 运行单个测试类中的所有用例：
EXEC tSQLt.Run 'MyStoredProcedureTests'; - 运行所有测试类中的用例：
EXEC tSQLt.RunAll; - 运行单个测试用例：
EXEC tSQLt.Run 'MyStoredProcedureTests.test_EnabledUserCountIsCorrect';
测试运行完成后，tSQLt会返回测试结果，包括通过的用例数量、失败的用例数量以及失败用例的具体错误信息，方便开发者快速定位问题。
注意事项
在编写存储过程单元测试时，需要注意以下几点：
- 尽量使用
tSQLt.FakeTable伪造业务表，避免测试操作影响实际业务数据 - 每个测试用例只验证一个逻辑点，保持用例的独立性
- 测试数据要覆盖正常场景、边界场景和异常场景，提升测试覆盖率
- 测试完成后不需要手动清理数据，tSQLt会自动回滚测试事务