OpenAPITools/openapi-generator Java枚举生成问题解析

在OpenAPITools/openapi-generator项目中，Java代码生成器在7.12.0版本中引入了一个关于枚举命名的变更，导致生成的枚举值会默认添加下划线前缀。这个问题主要影响从OpenAPI规范中的字符串枚举到Java枚举的转换过程。

问题现象

当使用7.12.0版本生成Java代码时，原本在OpenAPI规范中定义的枚举值如"C2C"会被转换为"C2_C"的形式。例如：

C2_C("C2C"),
CORE("CORE");

而在7.5.0版本中，生成的代码会保持原始形式：

B2B("C2C"),
CORE("CORE");

技术背景

这个变更源于Java代码生成器对枚举命名规则的调整。在7.12.0版本中，生成器默认采用了更严格的命名转换策略，目的是为了确保生成的枚举值符合Java命名规范，特别是当原始枚举值包含数字或其他可能不符合Java标识符规范的字符时。

解决方案

要恢复旧版本的行为，可以通过配置enumPropertyNaming参数为legacy来实现。这个参数控制着枚举值的命名转换策略：

• legacy：保持旧版本的命名行为，不添加额外下划线
• MACRO_CASE：使用全大写和下划线的命名方式（新版本的默认行为）

在Maven插件配置中，可以这样设置：

<configOptions>
    <enumPropertyNaming>legacy</enumPropertyNaming>
</configOptions>

深入理解

这个问题的本质是代码生成器在模型转换过程中的命名策略选择。OpenAPI规范中的枚举值作为字符串定义，需要转换为Java枚举的有效标识符。不同版本采用了不同的转换策略：

1. 旧版本采用宽松策略，直接使用原始值（或简单转换）
2. 新版本默认采用严格策略，确保生成的标识符符合Java规范

这种变化反映了项目在代码质量和规范一致性方面的持续改进，但也带来了向后兼容性的挑战。

最佳实践

对于需要升级到新版本的用户，建议：

1. 评估新命名策略是否适合项目需求
2. 如果依赖旧行为，明确配置enumPropertyNaming参数
3. 在升级前进行充分的代码生成测试
4. 考虑在团队内部统一命名策略标准

这个案例也提醒我们，在使用代码生成工具时，理解其配置选项和版本变更对生成结果的影响至关重要。通过合理配置，可以在保持代码规范的同时满足项目的特定需求。