如何让OpenAPI Generator生成JsonNode类型的customPayload变量？

以下几种方法可以让OpenAPI Generator生成JsonNode类型的customPayload字段：

方法1：修改OpenAPI Schema的扩展字段 #

直接在你的OpenAPI schema中添加x-java-type扩展，指定该字段生成的Java类型为JsonNode。修改后的schema如下：

customPayload:
  type: object
  nullable: true
  x-java-type: com.fasterxml.jackson.databind.JsonNode
  example:
    date: 2022-12-16
    randomStuff: "random stuff"

这个扩展会告诉生成器直接使用指定的Java类型，不再用JsonNullable<Object>包装，同时nullable: true会让字段支持null值，最终生成的代码就是你想要的private JsonNode customPayload;。

方法2：配置Gradle生成任务的全局参数 #

在build.gradle.kts的OpenAPI生成任务中，添加两个配置项：禁用JsonNullable的使用，同时指定默认的Object类型为JsonNode。示例配置如下：

tasks.withType<org.openapitools.generator.gradle.plugin.tasks.GenerateTask> {
    generatorName.set("java")
    // 你的其他配置（比如spec文件路径、输出目录等）
    configOptions.set(
        mapOf(
            "useJsonNullable" to "false", // 关闭JsonNullable包装，直接用Java可空类型
            "defaultObjectType" to "com.fasterxml.jackson.databind.JsonNode" // 全局默认Object类型设为JsonNode
        )
    )
}

这样所有未指定具体类型的object类型字段，都会生成JsonNode类型，且因为Java 17支持可空，字段会直接定义为private JsonNode customPayload;。

方法3：自定义生成器模板 #

如果前两种方法不符合你的需求，可以自定义OpenAPI Generator的模板文件：

1. 从OpenAPI Generator的Java模板库中复制model.mustache文件到你的项目目录（比如src/main/resources/openapi-templates/java）
2. 修改模板中处理object类型字段的逻辑，把原本生成JsonNullable<Object>的部分替换成JsonNode
3. 在Gradle任务中指定自定义模板的路径：

tasks.withType<org.openapitools.generator.gradle.plugin.tasks.GenerateTask> {
    // 其他配置...
    templateDir.set(file("src/main/resources/openapi-templates"))
}

这种方法灵活性最高，但需要熟悉模板的语法和生成逻辑。

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