OpenAPI Generator Maven插件自定义扩展标签失效问题求助

1. 确保Maven插件配置启用厂商扩展 #

在pom.xml的OpenAPI Generator插件配置中，必须显式启用厂商扩展支持，否则自定义的x-*字段不会被传递到模板。添加以下关键配置：

<plugin>
    <groupId>org.openapitools</groupId>
    <artifactId>openapi-generator-maven-plugin</artifactId>
    <version>你的版本号（建议使用最新稳定版）</version>
    <executions>
        <execution>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <inputSpec>${project.basedir}/src/main/resources/openapi.yaml</inputSpec>
                <generatorName>java</generatorName>
                <templateDirectory>${project.basedir}/src/main/resources/templates</templateDirectory>
                <!-- 插件级启用厂商扩展 -->
                <enableVendorExtensions>true</enableVendorExtensions>
                <configOptions>
                    <!-- Java生成器专属扩展开关 -->
                    <useVendorExtensions>true</useVendorExtensions>
                    <validateSpec>false</validateSpec>
                </configOptions>
            </configuration>
        </execution>
    </executions>
</plugin>

enableVendorExtensions是插件全局开关，useVendorExtensions是Java生成器的细分配置，两者必须同时设置才能确保扩展被传递到模板上下文。

2. 修正Mustache模板的变量访问语法 #

你的模板存在两处语法问题：

• 字符串类型扩展的存在性判断无需重复完整路径
• 数组类型扩展需要迭代元素，而非直接输出整个数组对象

修正后的模板示例：

/* This is proof that the vendor custom template (model) is engaged */

public class {{classname}} {
    {{#vars}}
    private {{datatype}} {{name}};
    {{/vars}}

    // Vendor Extensions Debug
    {{#vendorExtensions.x-model-debug}}
    System.out.println('x-model-debug: {{.}}');
    {{/vendorExtensions.x-model-debug}}

    {{#vendorExtensions.x-implements}}
    System.out.println('x-implements element: {{.}}');
    {{/vendorExtensions.x-implements}}
}

说明：

• {{.}}表示当前上下文的变量值：在字符串section中对应x-model-debug的内容，在数组迭代section中对应每个数组元素
• 使用单引号避免Java语法中双引号的转义问题

3. 调试验证模板上下文 #

如果仍未渲染，可先在模板中输出所有vendorExtensions内容，确认扩展是否被传递：

<!-- 临时调试：输出所有厂商扩展 -->
{{vendorExtensions}}

生成后查看User.java，若输出为空则是插件配置问题；若包含你的自定义扩展，则是模板语法问题。

4. 升级OpenAPI Generator版本 #

旧版本（v4.x及更早）对厂商扩展的支持存在局限性，建议升级到v6.x或v7.x的稳定版，新版本对自定义扩展的处理更完善。

最终验证 #

完成配置后执行mvn clean install，生成的User.java应包含预期内容：

/* This is proof that the vendor custom template (model) is engaged */

public class User {
    private Integer id;
    private String name;

    // Vendor Extensions Debug
    System.out.println('x-model-debug: User model vendor extension');
    System.out.println('x-implements element: Serializable');
}

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