如何为名称以数字开头的OpenAPI枚举生成合法Java模型？

以下几种方法可以解决该问题：

方法一：通过openapi-generator-maven-plugin配置映射类名 #

在插件配置中添加modelNameMappings参数，将非法的枚举名称映射为符合Java语法的合法名称，比如把3RIIndicator映射为ThreeRIIndicator。

示例Maven插件配置片段：

<plugin>
    <groupId>org.openapitools</groupId>
    <artifactId>openapi-generator-maven-plugin</artifactId>
    <version>你的插件版本</version>
    <executions>
        <execution>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <inputSpec>${project.basedir}/src/main/resources/openapi.yaml</inputSpec>
                <generatorName>java</generatorName>
                <!-- 其他基础配置 -->
                <modelNameMappings>
                    <modelNameMapping>3RIIndicator=ThreeRIIndicator</modelNameMapping>
                </modelNameMappings>
            </configuration>
        </execution>
    </executions>
</plugin>

方法二：修改OpenAPI YAML文件添加扩展属性 #

直接在供应商提供的YAML规范中，给目标枚举的schema添加x-java-class扩展字段，指定生成的Java类名。这种方式无需修改插件配置，直接调整源文件即可。

修改后的YAML片段：

3RIIndicator:
    type: string
    description: 'xxx'
    x-java-class: ThreeRIIndicator
    enum:
      - Recurringtransaction
      - Installmenttransaction
      - AddCard

方法三：自定义生成模板（进阶批量处理） #

如果需要批量处理所有以数字开头的类名，可以自定义openapi-generator的Java枚举模板：

1. 从openapi-generator的默认模板中复制Java枚举模板文件（通常为enum.mustache），放到项目的src/main/resources/templates目录下；
2. 修改模板中的类名生成逻辑，比如添加判断：若类名以数字开头，自动将数字替换为对应英文单词（如3→Three），或添加固定前缀（如Enum_）；
3. 在Maven插件配置中指定自定义模板目录：

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

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