OpenAPI Generator Gradle Plugin自定义模板不生效问题求助

针对你遇到的自定义js_jquery.mustache模板未生效的问题，可按以下步骤排查和修复：

1. 修正模板目录结构 #

html2生成器的内置模板目录名称是html2，而非htmlDocs2。请将自定义的js_jquery.mustache文件放到如下路径：

src/Resources/Documentation/Template/html2/js_jquery.mustache

注意：文件名和目录名的大小写需严格匹配（尤其是在类Unix系统下），否则插件会找不到自定义模板，自动 fallback 到内置模板。

2. 优化Gradle配置的可靠性 #

避免使用字符串拼接路径，改用Gradle的file()方法确保路径解析正确，同时可添加日志参数验证模板加载情况：

buildscript {
    repositories {
        mavenCentral()
    }
    
    dependencies {
        // 建议升级到最新稳定版，旧版本可能存在模板加载bug
        classpath 'org.openapitools:openapi-generator-gradle-plugin:7.6.0'
    }
}

apply plugin: 'org.openapi.generator'

openApiGenerate {
    generatorName = "html2"
    inputSpec.set(file("$rootDir/src/Resources/Documentation/My.yaml").absolutePath)
    outputDir.set(file("$rootDir/bin/apiGenerator").absolutePath)
    templateDir.set(file("$rootDir/src/Resources/Documentation/Template").absolutePath)
    // 开启 verbose 日志，查看模板加载路径
    verbose.set(true)
}

3. 清理缓存后重新生成 #

Gradle或OpenAPI Generator可能会缓存旧的生成文件，执行以下命令彻底清理并重新生成：

./gradlew clean openApiGenerate

4. 验证模板加载日志 #

执行任务后，查看控制台输出的日志，寻找类似如下的记录：

Loading template from: /your-project-path/src/Resources/Documentation/Template/html2/js_jquery.mustache

如果能看到这条日志，说明自定义模板已被正确加载；如果没有，需再次检查路径是否正确，或尝试升级插件版本。

5. 确认模板修改内容 #

确保自定义的js_jquery.mustache中确实替换了jQuery的版本，比如将原模板的：

<script src="https://code.jquery.com/jquery-1.11.3.min.js"></script>

替换为：

<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>

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