OpenAPI Generator 默认会移除枚举值中与字段名（如 sb）匹配的前缀（如 SB_），导致生成的 Java 枚举常量名异常（如 _150_150）。本文介绍通过配置 removeEnumValuePrefix=false 禁用该行为，实现原始枚举值到常量名的一对一映射。
openapi generator 默认会移除枚举值中与字段名（如 `sb`）匹配的前缀（如 `sb_`），导致生成的 java 枚举常量名异常（如 `_150_150`）。本文介绍通过配置 `removeenumvalueprefix=false` 禁用该行为，实现原始枚举值到常量名的一对一映射。
在使用 OpenAPI Generator（尤其是 Maven 插件）生成 Java 客户端或服务端代码时，若 OpenAPI 规范中定义了以特定前缀（如 SB_）开头的字符串枚举值，你可能会遇到枚举常量名被意外截断的问题。例如，以下 YAML 片段：
sb:
type: string
enum:
- SB_150_150
- SB_300_150默认生成的 Java 枚举类中，常量名会丢失 SB_ 前缀：
public enum SbEnum {
_150_150("SB_150_150"),
_300_150("SB_300_150");
// ...
}这是由于 OpenAPI Generator 内置的枚举值前缀自动剥离机制（removeEnumValuePrefix）默认启用：当枚举值以字段名（snake_case 或 UPPERCASE 形式推导出的前缀，如 `SB`）开头时，会将其移除以生成更“Java 风格”的常量名。虽然该机制在部分场景下有益，但在需要严格保留原始命名语义（如与外部系统约定一致、日志/调试可读性要求高）时，反而成为障碍。
✅ 解决方案：显式禁用前缀移除
在 pom.xml 的 openapi-generator-maven-plugin 配置中，添加 removeEnumValuePrefix=false 到
<plugin>
<groupId>org.openapitools</groupId>
<artifactId>openapi-generator-maven-plugin</artifactId>
<version>6.4.0</version>
<configuration>
<inputSpec>${project.basedir}/src/main/resources/openapi.yaml</inputSpec>
<generatorName>java</generatorName>
<!-- 关键配置：禁止自动移除枚举值前缀 -->
<additionalProperties>
<removeEnumValuePrefix>false</removeEnumValuePrefix>
</additionalProperties>
</configuration>
</plugin>执行 mvn clean generate-sources 后，即可获得预期结果：
public enum SbEnum {
SB_150_150("SB_150_150"),
SB_300_150("SB_300_150");
private final String value;
SbEnum(String value) { this.value = value; }
public String getValue() { return value; }
}⚠️ 注意事项
- 该配置仅影响枚举常量名（name() 返回值），不影响其关联的原始字符串值（getValue() 或 toString() 返回值），后者始终与 OpenAPI 中定义的 enum 字符串完全一致；
- 若项目中其他枚举依赖默认前缀移除逻辑（例如 status: [ACTIVE, INACTIVE] 期望生成 ACTIVE, INACTIVE 而非 STATUS_ACTIVE），请评估全局禁用的影响，必要时可通过 --global-property 或单独配置不同生成任务；
- 该选项自 OpenAPI Generator v5.4.0 起稳定支持，推荐使用 v6.x 及以上版本以获得完整兼容性与修复；
- 对于 Gradle 用户，等效配置为：
generatorName = "java" additionalProperties = [ "removeEnumValuePrefix": "false" ]
通过一行关键配置，即可精准控制枚举命名策略，在保持代码规范性的同时，尊重 OpenAPI 规范的原始语义——这是构建健壮、可维护 API 集成层的重要实践。
