openapi-generator-maven-plugin未生成可扩展枚举类问题求助

针对你用OpenAPI 3.0.1规范、openapi-generator-maven-plugin 7.1.0生成客户端时，x-extensible-enum被生成为字符串而非可扩展枚举的问题，给你两个可行的解决办法：

方法一：配置插件参数（优先尝试） #

openapi-generator默认未开启对x-extensible-enum扩展的支持，你需要在插件配置中添加相关参数启用可扩展枚举生成。以Java客户端为例，修改maven插件配置如下：

<plugin>
    <groupId>org.openapitools</groupId>
    <artifactId>openapi-generator-maven-plugin</artifactId>
    <version>7.1.0</version>
    <executions>
        <execution>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <inputSpec>${project.basedir}/src/main/resources/openapi.yaml</inputSpec>
                <generatorName>java</generatorName>
                <!-- 开启扩展字段支持 -->
                <enableExtensions>true</enableExtensions>
                <!-- 启用Java可扩展枚举生成 -->
                <enableJavaEnumExtensible>true</enableJavaEnumExtensible>
                <!-- 可选：生成未知枚举值的默认处理逻辑 -->
                <generateEnumDefaultCase>true</generateEnumDefaultCase>
                <!-- 其他自定义配置（如包名、输出目录等） -->
            </configuration>
        </execution>
    </executions>
</plugin>

如果是其他语言，替换对应参数即可：

• Python：添加<generateExtensibleEnums>true</generateExtensibleEnums>
• TypeScript：确保<enableExtensions>true</enableExtensions>，并添加<enumPropertyNaming>original</enumPropertyNaming>

方法二：自定义模板（兜底方案） #

如果插件参数配置无效，可通过自定义模板强制识别x-extensible-enum字段生成枚举类：

1. 从openapi-generator官方仓库下载对应语言的枚举模板（比如Java的enum.mustache）
2. 将模板复制到项目的src/main/resources/openapi-templates目录
3. 修改模板，添加对x-extensible-enum的处理逻辑。以Java为例，核心修改如下：

{{#isEnum}}
{{#x-extensible-enum}}
public enum {{classname}} {
    {{#x-extensible-enum}}
    {{toUpperCase .}}("{{.}}"){{^last}},{{/last}}
    {{/x-extensible-enum}},
    CUSTOM("");

    private final String value;

    {{classname}}(String value) {
        this.value = value;
    }

    @JsonValue
    public String getValue() {
        return value;
    }

    @JsonCreator
    public static {{classname}} fromValue(String value) {
        for ({{classname}} enumVal : {{classname}}.values()) {
            if (enumVal.value.equals(value)) {
                return enumVal;
            }
        }
        return CUSTOM;
    }
}
{{/x-extensible-enum}}
{{^x-extensible-enum}}
// 保留原模板的普通枚举生成逻辑
{{/x-extensible-enum}}
{{/isEnum}}

4. 在maven插件配置中指定自定义模板目录：

<configuration>
    <!-- 其他配置 -->
    <templateDirectory>${project.basedir}/src/main/resources/openapi-templates</templateDirectory>
</configuration>

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