使用openapi-generator-maven-plugin时ApiClient.mustache中allInterceptors无法解析的问题咨询

我来帮你一步步排查和解决这个问题——你配置了自定义拦截器的全类名，但生成的代码里却只出现new ()，拦截器类名完全丢失，主要可以从这几个方向找原因和解决办法：

一、先确认自定义模板是否真的生效了 #

首先得排除模板没被加载的情况：你可以在自定义的ApiClient.mustache里加一行显眼的注释，比如// 测试自定义模板生效，然后重新执行生成命令，看生成的ApiClient.java里有没有这行注释。如果没有，说明你的templateDirectory路径配置有问题，或者插件没正确读取到自定义模板，得先把这个基础问题解决。

二、模板变量的匹配与传递问题 #

你遇到的核心问题是模板没拿到allInterceptors变量的值，可能有这几个原因：

1. 变量类型不匹配：
   你在Maven里配置的allInterceptors是单个字符串，但模板里用了{{#allInterceptors}}这种列表遍历的语法。虽然Mustache对单个字符串的section会执行一次，但部分OpenAPI Generator版本可能对这种单个值转列表的处理有问题。
   解决办法：要么把模板改成直接取值（如果只需要单个拦截器的话），比如把这段逻辑替换成：

   {{#allInterceptors}}
   interceptors.add(new {{allInterceptors}}());
   {{/allInterceptors}}
   

   或者如果需要支持多个拦截器，把配置改成逗号分隔的列表：

   <allInterceptors>derrick.com.app.interceptor.TestLoggingInterceptor,com.xxx.AnotherInterceptor</allInterceptors>
   

   这样模板里的{{#allInterceptors}}就能正确遍历每个拦截器类名。

2. 参数传递的位置不对：
   你现在把allInterceptors放在additionalProperties里，但有些自定义变量需要放到configOptions下才能被模板读取到。可以试试把配置移到configOptions里：

   <configOptions>
     <!-- 你的其他配置项 -->
     <allInterceptors>derrick.com.app.interceptor.TestLoggingInterceptor</allInterceptors>
   </configOptions>
   

3. 变量名称冲突：
   会不会allInterceptors是OpenAPI Generator内置的变量名，但在6.6.0版本里这个变量有特殊处理？可以试试换个变量名，比如改成customInterceptors，然后模板里对应改成{{#customInterceptors}}和{{.}}，同时Maven配置里也同步修改变量名。

三、简化逻辑：改用单个拦截器的配置（如果只需要一个的话） #

如果你的场景里只需要加这一个拦截器，完全可以简化模板和配置，避免列表处理的坑：

1. Maven配置里改成单个变量：

   <additionalProperties>
     <customInterceptor>derrick.com.app.interceptor.TestLoggingInterceptor</customInterceptor>
   </additionalProperties>
   

2. 模板里的对应逻辑改成：

   List<Interceptor> interceptors = new ArrayList<>();
   {{#customInterceptor}}
   interceptors.add(new {{customInterceptor}}());
   {{/customInterceptor}}
   initHttpClient(interceptors);
   

   这样逻辑更简单，出错概率也低。

四、别忘了补全导入语句 #

最后提醒一下：即使拦截器类名正确生成了，ApiClient.java里还需要对应的导入语句，不然会编译报错。你可以在模板的import区域加上这段：

{{#allInterceptors}}
import {{.}};
{{/allInterceptors}}
<!-- 或者单个拦截器的情况 -->
{{#customInterceptor}}
import {{customInterceptor}};
{{/customInterceptor}}

五、版本兼容性问题 #

你用的是6.6.0版本，这个版本可能存在一些参数传递的小bug，可以尝试升级到最新的稳定版（比如7.6.0），很多旧版本的问题在新版本里都被修复了。

内容来源于stack exchange