Micronaut 1.0.2单元测试疑问：@MicronautTest注解失效及无服务器测试方案

我来帮你梳理下这些问题，结合你使用的Micronaut 1.0.2版本逐一解答：

@MicronautTest的作用是什么？ #

它相当于Spring Boot里的@SpringBootTest，核心作用是帮你启动Micronaut的测试上下文：自动初始化应用的Bean容器，按需启动嵌入式服务器，并且支持依赖注入——你不用手动写ApplicationContext.run()这种代码，就能直接注入EmbeddedServer、HttpClient或者自定义的客户端接口，大大简化测试代码。

为什么@Inject、@Client、EmbeddedServer注入为null？ #

在Micronaut 1.0.2这个早期版本里，光加@MicronautTest还不够，你漏了两个关键配置：

1. 缺少测试运行器注解
   Micronaut 1.x的测试需要配合对应JUnit版本的运行器注解。如果你用的是JUnit 4，必须在测试类上额外加上@RunWith(MicronautJUnit4Runner.class)；如果是JUnit 5，则需要@ExtendWith(MicronautExtension.class)。没有这个注解，@MicronautTest根本不会生效，自然无法注入任何Bean。

2. 未引入正确的测试依赖
   你需要在构建文件（Maven/Gradle）中加入Micronaut的测试启动器依赖，比如JUnit 4的依赖：

   • Maven：

     <dependency>
         <groupId>io.micronaut.test</groupId>
         <artifactId>micronaut-test-junit4</artifactId>
         <version>1.0.2</version>
         <scope>test</scope>
     </dependency>
     

   • Gradle：

     testImplementation "io.micronaut.test:micronaut-test-junit4:1.0.2"
     

正确的测试写法示例 #

1. 用HttpClient测试REST端点

@RunWith(MicronautJUnit4Runner.class)
@MicronautTest
class HelloControllerSpec {
    @Inject
    EmbeddedServer server;
    
    @Inject
    @Client("/")
    HttpClient client;

    @Test
    void testHelloWorldResponse() {
        // 发送请求并验证响应
        HttpResponse<String> response = client.toBlocking().exchange("/hello", String.class);
        assert response.status().equals(HttpStatus.OK);
        assert response.body().equals("Hello");
    }
}

2. 用编译时客户端测试

先定义客户端接口：

@Client("/")
public interface HelloClient {
    @Get("/hello")
    String getHello();
}

然后编写测试：

@RunWith(MicronautJUnit4Runner.class)
@MicronautTest
public class HelloClientSpec {
    @Inject
    HelloClient client;

    @Test
    public void testHelloWorldResponse(){
        String result = client.getHello();
        assert result.equals("Hello");
    }
}

Micronaut中类似Spring MockMvc的方案（不启动完整服务器） #

如果你只想测试Web层逻辑，不想启动嵌入式服务器，可以通过两种方式实现：

1. 直接测试控制器实例

禁用嵌入式服务器，直接注入控制器类：

@RunWith(MicronautJUnit4Runner.class)
@MicronautTest(embeddedServer = false)
class HelloControllerSpec {
    @Inject
    HelloController controller;

    @Test
    void testHello() {
        assert controller.hello().equals("Hello");
    }
}

2. 模拟HTTP请求（无需启动服务器）

通过Router和MockHttpRequest模拟请求流程，完全在内存中测试：

@RunWith(MicronautJUnit4Runner.class)
@MicronautTest(embeddedServer = false)
class HelloControllerSpec {
    @Inject
    Router router;

    @Test
    void testHelloRequest() {
        // 构造模拟请求
        MockHttpRequest request = MockHttpRequest.GET("/hello");
        // 查找匹配的路由
        Optional<RouteMatch<?>> routeMatch = router.find(request);
        assert routeMatch.isPresent();
        
        // 执行路由并验证结果
        Object result = routeMatch.get().execute();
        assert result.equals("Hello");
    }
}

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