Micronaut控制器Spock功能测试返回404错误排查问询

先梳理下你遇到的几个核心问题，咱们一步步拆解解决：

一、测试返回404的核心原因排查 #

你的控制器代码逻辑没问题，但测试里的EmbeddedServer大概率没正确加载到Greetings控制器，常见原因有两个：

1. 包扫描范围不匹配 #

Micronaut默认只会扫描应用主类所在包及其子包下的控制器。如果你的GreetingsController和测试类TacRulesControllerSpec不在同一个包（或子包）内，启动EmbeddedServer时就不会自动发现这个控制器。

解决办法：

• 要么把测试类移到控制器所在的包/子包下；
• 要么启动EmbeddedServer时手动指定扫描包：

EmbeddedServer embeddedServer = ApplicationContext.run(EmbeddedServer, [
    "micronaut.server.packages": "com.yourpackage.controllers" // 替换为你的控制器实际所在包
])

2. 尝试用声明式HttpClient简化测试 #

传统的手动创建HttpClient容易出现路径拼接或配置疏漏，换成Micronaut的声明式客户端会更稳妥：

@Client("/")
interface GreetingsClient {
    @Get("/greetings/{name}")
    String greet(String name)
}

// 测试类中调整客户端初始化
@Shared @AutoCleanup
EmbeddedServer embeddedServer = ApplicationContext.run(EmbeddedServer)
@Shared
GreetingsClient client = embeddedServer.applicationContext.getBean(GreetingsClient)

// 测试方法简化
def "greetings controller check" () {
    when:
    String response = client.greet("bon")
    then:
    response == "hello bon"
}

二、API报错日志未正常传播的问题 #

从你提供的日志来看，其实已经有TRACE级别的详细响应记录了，但默认日志级别可能没开到位，导致错误信息不够显眼。另外测试中抛出的HttpClientResponseException如果没被捕获，会直接导致测试失败，但错误日志可能没被正确输出到控制台。

解决办法：
在src/test/resources/logback-test.xml里调整日志级别，让服务器和客户端的日志更清晰：

<configuration>
    <logger name="io.micronaut.http.client" level="DEBUG"/>
    <logger name="io.micronaut.http.server" level="DEBUG"/>
    <root level="INFO"/>
</configuration>

开启后就能看到服务器端的路由匹配日志，确认控制器是否被正确注册，以及请求是否命中了预期端点。

三、实际API返回400但客户端收到404的情况 #

这种情况基本是路由匹配失败导致的：

• 请求参数类型和控制器定义不匹配（比如控制器要求Integer，但你传了字符串）；
• 请求路径拼写错误、HTTP方法不匹配（比如控制器是@Post但你用了GET）；
• 路由模板参数未正确传递或格式不符合要求。

Micronaut在找不到匹配路由时，会直接返回404而非400。开启服务器端DEBUG日志后，就能看到路由匹配的全过程，快速定位问题。

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