Java模块化项目中高质量集成测试需尊重封装、聚焦真实协作，用Testcontainers等构建可控环境，覆盖空值传播、并发一致性、事务边界等风险点。
在 Java 模块化项目（如基于 JPMS 的 module-info.java 结构）中编写高质量的集成测试用例，关键不是绕过模块边界，而是尊重模块封装、精准控制依赖可见性，并聚焦组件间真实协作路径。测试本身不参与模块系统运行时的模块声明，但必须适配其访问约束。
明确测试目标与范围
集成测试应验证跨模块的交互是否符合设计契约，例如：
- Service 模块调用 Repository 模块的数据访问逻辑是否正确落库并返回
- API 模块通过导出的接口消费 Domain 模块的领域对象，序列化/反序列化是否保持一致性
- 多个模块共用的配置或事件总线（如 Spring Event、自定义 EventBus）能否跨模块触发与监听
避免把“能跑通”当作合格——要检查状态流转、异常传播、事务边界、资源释放等真实集成行为。
合理组织测试代码结构
Maven 项目中建议物理隔离单元测试与集成测试：
立即学习“Java免费学习笔记（深入）”；
- 单元测试保留在
src/test/java，使用@Mock+@InjectMocks隔离模块依赖 - 集成测试统一放在
src/integration-test/java，配合maven-failsafe-plugin执行（不被mvn test触发） - 测试资源（如
application-it.yml、SQL 初始化脚本）放在src/integration-test/resources
模块化项目中，module-info.java 不需要为测试模块显式开放 opens 或 exports；测试类运行在未命名模块（unnamed module），天然可反射访问已编译的命名模块内部类（前提是模块未强封装）。但建议只访问 public 类型和 API，保持测试稳定性。
构建真实、可控的集成环境
不用“本地内存数据库+手动建表”这种易失真方案。推荐组合：
- 用 Testcontainers 启动轻量级 PostgreSQL/MySQL 容器，保证 DDL、事务、索引行为与生产一致
- 用 @SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT) 启动完整 Web 层，验证 Controller → Service → Repository 全链路
- 对涉及外部 HTTP 调用的模块，用 WireMock 或 MockServer 替代真实服务，控制响应延迟、状态码、超时等边界场景
示例片段（JUnit 5 + Testcontainers）：
@SpringBootTest
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
class OrderServiceIntegrationTest {
@Container
static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:15")
.withDatabaseName("itdb")
.withUsername("ituser")
.withPassword("itpass");
@DynamicPropertySource
static void configureProperties(DynamicPropertyRegistry registry) {
registry.add("spring.datasource.url", postgres::getJdbcUrl);
registry.add("spring.datasource.username", postgres::getUsername);
registry.add("spring.datasource.password", postgres::getPassword);
}
@Test
void shouldPlaceOrderAndPersist() {
// given
OrderRequest request = new OrderRequest("SKU-001", 2);
// when
ResponseEntity<OrderResponse> response = restTemplate.postForEntity(
"/api/orders", request, OrderResponse.class);
// then
assertThat(response.getStatusCode()).isEqualTo(HttpStatus.CREATED);
assertThat(response.getBody().getId()).isNotNull();
}
}
覆盖典型集成风险点
高质量集成测试需主动覆盖以下易出问题的场景：
-
空值与非法输入传播：前端传 null ID，Repository 是否抛出
DataIntegrityViolationException，Service 是否捕获并转为合适业务异常 -
并发写入一致性：用
Executors.newFixedThreadPool(10)并发提交相同订单，验证唯一约束或乐观锁是否生效 -
跨模块事务边界：Service A 调用 Service B，B 抛异常时 A 的 DB 操作是否回滚（需
@Transactional正确传播） -
模块间类型兼容性：Domain 模块定义
Money值对象，API 模块 JSON 序列化后能否无损还原（含精度、单位字段）
每个用例只验证一个核心集成契约，失败时能快速定位是接口契约错、实现错，还是环境配置错。
