openapi-generator Maven插件生成含«»的无效Java代码问题求助

针对你从swagger-codegen迁移到openapi-generator后，遇到ResultList«GenericRow»生成的equals方法中出现无效变量名的问题，这里有几个可行的解决方案：

1. 启用名称清理配置 #

在Maven插件的configOptions中添加sanitizeNames配置，让生成器自动清理变量名中的特殊字符，和swagger-codegen的行为对齐：

<configOptions>
  <library>resttemplate</library>
  <dateLibrary>java8</dateLibrary>
  <sanitizeNames>true</sanitizeNames> <!-- 新增该配置，自动清理非法字符 -->
</configOptions>

这个配置会自动移除变量名中的非字母数字字符，把类似resultList«GenericRow»的无效变量名转换为合法的resultListGenericRow。

2. 自定义模板覆盖equals方法生成逻辑 #

如果sanitizeNames配置不生效，或者需要更精细的控制，可以通过自定义模板修改equals方法的生成逻辑：

• 在项目中创建目录src/main/resources/openapi-templates/java
• 从openapi-generator对应版本的Java模板库中复制equals.mustache文件到该目录
• 修改模板中的变量名处理逻辑，比如添加特殊字符替换规则，例如将模板中引用变量名的部分调整为{{name.replace("«", "").replace("»", "")}}（需符合mustache语法）
• 在Maven插件配置中指定自定义模板目录：

<configOptions>
  <library>resttemplate</library>
  <dateLibrary>java8</dateLibrary>
  <templateDirectory>${project.basedir}/src/main/resources/openapi-templates/java</templateDirectory>
</configOptions>

3. 预处理Swagger规范文件 #

如果上述方法都不适用，可以在生成代码前预处理你的api-tpz.json文件，替换掉定义中的特殊字符：

• 使用Maven的replacer插件在openapi-generator执行前替换文件内容：

<plugin>
  <groupId>com.google.code.maven-replacer-plugin</groupId>
  <artifactId>replacer</artifactId>
  <version>1.5.3</version>
  <executions>
    <execution>
      <phase>generate-sources</phase>
      <goals>
        <goal>replace</goal>
      </goals>
      <configuration>
        <file>${project.basedir}/src/main/resources/api-tpz.json</file>
        <replacements>
          <replacement>
            <token>ResultList«GenericRow»</token>
            <value>ResultListGenericRow</value>
          </replacement>
        </replacements>
      </configuration>
    </execution>
  </executions>
</plugin>

确保该插件在openapi-generator插件之前执行。

验证方式 #

生成代码后检查ResultListGenericRow.java中的equals方法，确认变量名已变为合法的Java标识符，比如resultListGenericRow而非带特殊符号的版本即可。

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