Micronaut Integration Testing

Prove real wiring in Micronaut with containers and HTTP.

What is covered in this Skill?

• Scope: contracts and boundaries, not duplicated unit-test logic
• TestPropertyProvider + static @Container for JDBC/Kafka properties
• HttpClient full-stack HTTP assertions
• @MicronautTest(transactional = true) for rollback where supported
• Shared containers per class; pinned image tags
• Maven Surefire/Failsafe: *Test / *Tests vs *IT / *AT; explicit plugin includes and excludes

Scope: Apply recommendations based on the reference rules and good/bad code examples.

Constraints

Before applying any integration test changes, ensure the project compiles. If compilation fails, stop immediately. After applying improvements, run full verification.

• MANDATORY: Run ./mvnw compile or mvn compile before applying any change
• PREREQUISITE: Project must compile successfully and pass basic validation checks before any test refactoring
• CRITICAL SAFETY: If compilation fails, IMMEDIATELY STOP and DO NOT CONTINUE with any recommendations
• BLOCKING CONDITION: Compilation errors must be resolved by the user before proceeding with integration test changes
• NO EXCEPTIONS: Under no circumstances should testing recommendations be applied to a project that fails to compile
• VERIFY: Run ./mvnw clean verify or mvn clean verify after applying improvements
• BEFORE APPLYING: Read the reference for detailed rules and examples

When to use this skill

• Add Micronaut integration tests with Testcontainers
• Wire dynamic datasource or broker URLs for @MicronautTest

Reference

For detailed guidance, examples, and constraints, see references/522-frameworks-micronaut-testing-integration-tests.md.