Micronaut POST接口无法解析自定义对象，提示请求体缺失

针对你遇到的Required Body [body] not specified错误，按以下步骤排查解决：

1. 确认请求发送规范 #

• 必须携带Content-Type: application/json请求头，否则Micronaut无法识别JSON格式的请求体。
• 确保请求体非空且格式正确，比如用curl测试的示例命令：

  curl -X POST http://localhost:8080/v1/verify \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-token" \
  -d '{"username":"test","email":"test@example.com"}'
  

2. 修正Controller定义 #

Micronaut虽然支持在接口上标注@Controller，但需要对应的实现类才能正常处理请求，更简便的方式是直接使用类作为Controller：

@Controller("/v1")
@Secured(IS_AUTHENTICATED)
public class OTPHandlerController {

    @Post("/verify")
    @Consumes(MediaType.APPLICATION_JSON)
    public HttpResponse<User> verify(@Body User body) {
        // 业务逻辑实现
        return HttpResponse.ok(body);
    }
}

3. 确保自定义User类可序列化 #

• 添加无参构造函数：Jackson需要无参构造来实例化对象。
• 为字段添加getter/setter，或使用Lombok的@Data注解自动生成：

import lombok.Data;

@Data
public class User {
    private String username;
    private String email;
    // 其他业务字段
}

4. 检查依赖与配置 #

• 确认项目依赖中包含Jackson绑定模块（Micronaut默认集成，但需确保未被移除）：
  Gradle：

  implementation("io.micronaut:micronaut-jackson-databind")
  

  Maven：

  <dependency>
      <groupId>io.micronaut</groupId>
      <artifactId>micronaut-jackson-databind</artifactId>
  </dependency>
  

• 检查配置文件（application.yml/application.properties），确保未禁用请求体解析：

  micronaut:
    server:
      disable-request-body-parsing: false
  

5. 排查过滤器/拦截器影响 #

如果自定义了过滤器或拦截器，避免提前消耗请求体（请求体只能被读取一次）。若必须读取，需通过ServerRequestCache缓存请求体，示例：

@Filter("/**")
public class RequestBodyCacheFilter implements HttpFilter {
    @Override
    public Publisher<MutableHttpResponse<?>> doFilter(HttpRequest<?> request, FilterChain chain) {
        return ServerRequestCache.cacheRequest(request).flatMap(chain::proceed);
    }
}

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