Spring API测试报错：JSON path "$"集合大小断言失败

1. 核心问题：测试环境无数据导致断言失败 #

OpenAPI测试正常说明生产/开发环境有数据，但单元测试是隔离环境（默认使用内存数据库），每次测试都会重置，必须手动初始化测试数据。

解决方法： #

在测试类中添加数据初始化逻辑：

• 用@BeforeEach注解在每次测试前插入数据：

@Autowired
private UserRepository userRepository;

@BeforeEach
void setUp() {
    // 清空旧数据，避免测试污染
    userRepository.deleteAll();
    // 插入3条测试用户
    userRepository.save(new User("张三"));
    userRepository.save(new User("李四"));
    userRepository.save(new User("王五"));
}

• 或者用@Sql注解加载SQL脚本：

@SpringBootTest
@AutoConfigureMockMvc
@Sql("/test-users.sql") // 脚本里写INSERT语句插入3条数据
class UserControllerTest {
    // ...测试代码
}

2. 检查测试类配置是否正确 #

确保测试类具备以下注解，才能正确启动Spring上下文并模拟MVC请求：

@SpringBootTest
@AutoConfigureMockMvc
class UserControllerTest {
    @Autowired
    private MockMvc mockMvc; // 必须由Spring注入，不能手动new

    // ...测试方法
}

3. 解决UserRepository使用报错 #

如果直接注入UserRepository报错，检查：

• 测试类是否加了@SpringBootTest（会自动扫描所有Repository接口）；
• UserRepository接口是否继承了JpaRepository或CrudRepository（Spring Data JPA会自动生成实现类）；
• 避免使用切片测试（如@DataJpaTest），新手直接用@SpringBootTest减少配置问题。

4. 解决VSCode测试窗口无println输出 #

VSCode默认可能屏蔽测试控制台输出，调整配置即可：

• 在.vscode/settings.json中添加：

{
  "java.test.config": {
    "vmArgs": "-Dspring.output.ansi.enabled=ALWAYS"
  }
}

• 或者运行测试时选择「Run with Console」选项，也可以用SLF4J日志替代System.out.println（日志会默认输出到测试窗口）：

private static final Logger logger = LoggerFactory.getLogger(UserControllerTest.class);

// 调试时用
logger.info("当前用户数量：{}", userRepository.count());

5. 验证接口请求路径是否匹配 #

检查Controller的请求路径和测试代码中的路径是否一致，比如：

• Controller中：@GetMapping("/users")
• 测试代码中：mockMvc.perform(get("/users")...)
  避免路径拼写错误导致返回空集合。

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