japidocs生成的请求体没值

请问用japidocs生成接口文档,请求体没值,是有加注释的

该回答引用GPTᴼᴾᴱᴺᴬᴵ
确保在使用 Japidocs 生成接口文档时,已经正确地添加了请求体的注释。

通常,Japidocs 使用类注释中的 @param 标签生成请求体。例如,如果您有一个 POST 请求并且需要一个 JSON 对象作为请求体,则可以在请求处理方法中添加类似以下注释:

/**
 * 创建用户
 *
 * @param user 用户对象
 * @return 成功则返回创建的用户对象,否则返回错误信息
 */
@PostMapping("/users")
public ResponseEntity<?> createUser(@RequestBody User user) {
    // 处理创建用户的逻辑
}


在这个例子中,@RequestBody 注解告诉 SpringMVC,要将请求体中的 JSON 对象映射到 User 对象中,而 @param 注释告诉 Japidocs 要在接口文档中显示一个 JSON 请求体示例。

如果您的请求体没有显示在 Japidocs 生成的接口文档中,请检查您的注释是否正确,并确保您已经正确地指定了请求体的格式。

  • 这篇博客: 自动生成接口文档之JApiDocs教程中的 1、如何排查错误? 部分也许能够解决你的问题, 你可以仔细阅读以下内容或跳转源博客中阅读:
  • 关闭自动生成config.setAutoGenerate(Boolean.FALSE),使用@ApiDoc 来一个个接口导出排查问题。