Micronaut @Error 注解失效问题解析与正确实践

@Get(uri = "/{id}")
@Secured("ROLE_VIEW")
HttpResponse<AuthorResource> show(Long id) {
    try {
        // authorService.get(id) 可能会返回 io.vavr.control.Try 或抛出 ErrorContext 异常
        ok(authorService.get(id).get())
    } catch (Exception e) {
        e.printStackTrace()
        throw e // 重新抛出异常，期望被 @Error 处理器捕获
    }
}

// 错误的 HttpRequest 导入示例，导致 @Error 注解失效
// import java.net.http.HttpRequest // 这是 Java 11+ 的标准 HTTP 客户端，不是 Micronaut 的服务器端请求对象

@Error(exception = ErrorContext, global = true)
HttpResponse<ErrorContext> onErrorContext(HttpRequest request, ErrorContext error) {
    // 预期：根据 ErrorContext 中的 code 设置 HTTP 状态码并返回错误体
    HttpResponse.<ErrorContext>status(HttpStatus.valueOf(error.code)).body(error)
}

import io.micronaut.http.HttpRequest // 正确的导入方式
import io.micronaut.http.HttpResponse
import io.micronaut.http.HttpStatus
import io.micronaut.http.annotation.Error
import io.micronaut.http.annotation.Get
import io.micronaut.security.annotation.Secured
import example.ErrorContext // 假设这是你的自定义异常类
import example.AuthorResource // 假设这是你的资源类

// ... 其他导入

@Controller("/author")
class AuthorController {

    // ... 其他依赖注入

    @Get(uri = "/{id}")
    @Secured("ROLE_VIEW")
    HttpResponse<AuthorResource> show(Long id) {
        try {
            // 业务逻辑，可能抛出 ErrorContext 异常
            // ok(authorService.get(id).get())
            throw new ErrorContext(HttpStatus.NOT_FOUND.code, "Author with id ${id} not found.")
        } catch (Exception e) {
            e.printStackTrace()
            throw e
        }
    }

    // 正确的错误处理器
    @Error(exception = ErrorContext, global = true)
    HttpResponse<ErrorContext> onErrorContext(HttpRequest request, ErrorContext error) {
        // 现在 Micronaut 能够正确注入 HttpRequest 对象
        HttpResponse.<ErrorContext>status(HttpStatus.valueOf(error.code)).body(error)
    }
}

import io.micronaut.http.HttpRequest
import io.micronaut.http.HttpMethod
import io.micronaut.http.client.HttpClient
import io.micronaut.http.client.annotation.Client
import io.micronaut.http.client.exceptions.HttpClientResponseException
import io.micronaut.test.extensions.spock.annotation.MicronautTest
import jakarta.inject.Inject
import spock.lang.Specification
import spock.lang.IgnoreRest // 根据需要使用
import static io.micronaut.http.HttpStatus.NOT_FOUND
import static org.spockframework.util.ThreadSafeRandom.anyInt

@MicronautTest
class AuthorControllerSpec extends Specification {

    @Inject
    @Client("/author") // 注入针对 /author 路径的 HttpClient
    HttpClient client

    // 假设 viewer() 是一个获取认证 token 的辅助方法
    def viewer() {
        // 返回一个模拟的或实际的认证 token
        "some-auth-token"
    }

    @IgnoreRest // 如果你不想运行所有测试，可以暂时忽略此方法
    def "It fails to get an non-existing Author with an HttpClient"() {
        given:
        def token = viewer() // 获取认证token

        when:
        // 使用 Micronaut HttpClient 发送 GET 请求
        def author = client.toBlocking().exchange(HttpRequest.create(
                HttpMethod.GET,
                "/" + badId // 请求一个不存在的ID
        ).bearerAuth(token))

        then:
        // 期望捕获 HttpClientResponseException
        def ex = thrown(HttpClientResponseException)
        // 验证异常的 HTTP 状态码是否为 NOT_FOUND (404)
        ex.status == NOT_FOUND
        // 验证响应体中是否包含预期的错误信息
        ex.getResponse().getBody(ErrorResource).map {
            assert it.message == "Author with id ${badId} not found."
            it
        }.isPresent()

        where:
        badId = anyInt() // 使用 Spock 的数据驱动测试，生成随机 ID
    }
}