如何编写读取CSV文件的Spring Boot Controller集成测试？

核心结论：用真实示例CSV做集成测试完全可行 #

你提到的用含模拟数据的CSV模板验证读取结果，完全适配这类场景。集成测试的核心是验证全链路正确性——从Controller接收请求、调用OpenCSV解析、到返回处理后的数据，用真实CSV文件能覆盖更多实际场景（比如格式异常、特殊字符、空值等），比Mock更贴近生产环境。

具体实现步骤 #

1. 准备测试用CSV文件 #

在src/test/resources下创建测试目录（比如test-csvs），放入多场景CSV：

• 正常数据的CSV：验证解析逻辑正确性
• 格式异常的CSV：比如缺少字段、分隔符错误，验证错误处理逻辑
• 含特殊字符/空值的CSV：验证边界场景处理

2. 编写集成测试用例 #

用Spring Boot的@SpringBootTest配合MockMvc模拟请求，读取测试CSV作为请求参数：

@SpringBootTest
@AutoConfigureMockMvc
class CsvControllerIntegrationTest {

    @Autowired
    private MockMvc mockMvc;

    @Test
    void shouldReturnParsedDataWhenValidCsvIsUploaded() throws Exception {
        // 加载测试用正常CSV
        Resource csvResource = new ClassPathResource("test-csvs/valid-data.csv");
        MockMultipartFile multipartFile = new MockMultipartFile(
                "file",
                "valid-data.csv",
                MediaType.TEXT_PLAIN_VALUE,
                csvResource.getInputStream()
        );

        // 模拟上传并验证返回结果
        mockMvc.perform(multipart("/api/csv/parse")
                        .file(multipartFile))
                .andExpect(status().isOk())
                .andExpect(jsonPath("$.length()").value(3)) // 假设CSV含3条数据
                .andExpect(jsonPath("$[0].username").value("Alice"));
    }

    @Test
    void shouldReturnBadRequestWhenInvalidCsvIsUploaded() throws Exception {
        // 加载格式错误的CSV
        Resource invalidCsv = new ClassPathResource("test-csvs/invalid-format.csv");
        MockMultipartFile multipartFile = new MockMultipartFile(
                "file",
                "invalid-format.csv",
                MediaType.TEXT_PLAIN_VALUE,
                invalidCsv.getInputStream()
        );

        mockMvc.perform(multipart("/api/csv/parse")
                        .file(multipartFile))
                .andExpect(status().isBadRequest())
                .andExpect(content().string("CSV格式不符合要求"));
    }
}

3. 关键注意事项 #

• 测试数据隔离：每个用例使用独立CSV文件，避免数据互相干扰
• 覆盖边界场景：不要仅测试正常情况，还要验证空文件、超大文件（若有大小限制）、编码错误等场景
• 避免外部依赖：所有测试CSV都放在测试资源目录，保证测试可重复运行

和数据库集成测试的类比 #

你提到的H2嵌入式数据库思路，本质是用轻量级真实组件替代生产依赖，这个逻辑完全可以迁移到CSV场景：用真实CSV文件替代生产环境的用户上传文件，用OpenCSV真实解析逻辑替代Mock，以此验证全流程正确性，而非仅测试Controller层逻辑。

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