如何解决OpenAPI Generator Maven Plugin的Type引用歧义错误？

问题现象 #

生成Java客户端代码时出现编译错误：

[ERROR] /Users/debrajmanna/code/java/github/spotnana/src/java/openapi-generator/target/generated-sources/openapi/client/src/main/java/org/openapitools/client/model/ServiceChargeRecord.java:[76,10] error: reference to Type is ambiguous
  both enum org.openapitools.client.model.Type in org.openapitools.client.model and interface java.lang.reflect.Type in java.lang.reflect match
[ERROR] /Users/debrajmanna/code/java/github/spotnana/src/java/openapi-generator/target/generated-sources/openapi/client/src/main/java/org/openapitools/client/model/ServiceChargeRecord.java:[164,41] error: reference to Type is ambiguous

原因是OpenAPI定义中存在名为Type的枚举，生成代码后与JDK内置的java.lang.reflect.Type接口重名，导致编译器无法区分引用。

解决方案 #

方案1：修改OpenAPI规范中的枚举名称 #

直接在Api.yaml中将枚举Type重命名为更具业务辨识度的名称（例如ServiceChargeType），从根源避免命名冲突，这是最彻底的解决方式。

方案2：通过typeMappings映射重命名生成的枚举 #

若无法修改原OpenAPI规范，在Maven插件的客户端执行配置中添加typeMappings，将原枚举名映射为新名称：
在<execution id="generate-client">的<configuration>节点内添加：

<typeMappings>
  <typeMapping>Type=ServiceChargeType</typeMapping>
</typeMappings>

修改后的客户端执行配置片段如下：

<execution>
  <id>generate-client</id>
  <phase>generate-sources</phase>
  <goals>
    <goal>generate</goal>
  </goals>
  <configuration>
    <inputSpec>${project.basedir}/target/classes/generated/yaml/apis/api/Api.yaml</inputSpec>
    <generatorName>java</generatorName>
    <generateApiDocumentation>false</generateApiDocumentation>
    <modelNamePrefix>Spotnana</modelNamePrefix>
    <generateModels>true</generateModels>
    <generateApis>true</generateApis>
    <library>okhttp-gson</library>
    <typeMappings>
      <typeMapping>Type=ServiceChargeType</typeMapping>
    </typeMappings>
    <configOptions>
      <library>okhttp-gson</library>
    </configOptions>
    <additionalProperties>removeEnumValuePrefix=true</additionalProperties>
    <output>${project.build.directory}/generated-sources/openapi/client</output>
  </configuration>
</execution>

方案3：配置生成器排除冲突的自动导入 #

在客户端生成的additionalProperties中添加importJavaLangReflectType=false，阻止生成器自动导入java.lang.reflect.Type：

<additionalProperties>removeEnumValuePrefix=true,importJavaLangReflectType=false</additionalProperties>

此方式下生成的代码不会导入java.lang.reflect.Type，后续若需使用该类需用全限定名，但可直接解决当前的引用歧义问题。

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