是否可在openapi-generator-maven-plugin中传入输入YAML规范的HTTP URL？

当然可以！openapi-generator-maven-plugin完全支持通过HTTP URL加载你的OpenAPI YAML规范，而且有不少实用技巧能帮你轻松保持输入规范和生成代码的同步状态。

在你的pom.xml中，只需要将插件的<inputSpec>参数设置为远程YAML规范的HTTP URL即可。这里给你一个完整的配置示例：

<plugin>
    <groupId>org.openapitools</groupId>
    <artifactId>openapi-generator-maven-plugin</artifactId>
    <!-- 建议使用最新稳定版本 -->
    <version>7.6.0</version>
    <executions>
        <execution>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <!-- 直接指定远程OpenAPI规范的HTTP URL -->
                <inputSpec>https://your-api-server.com/openapi/openapi-spec.yaml</inputSpec>
                <!-- 配置生成的目标语言，比如Java、Python等 -->
                <generatorName>java</generatorName>
                <!-- 代码输出目录 -->
                <output>${project.build.directory}/generated-sources/openapi</output>
                
                <!-- 如果远程规范需要认证，添加HTTP头配置 -->
                <httpHeaders>
                    <header>Authorization: Bearer YOUR_ACCESS_TOKEN</header>
                </httpHeaders>
                
                <!-- 其他自定义配置（根据你的需求调整） -->
                <configOptions>
                    <sourceFolder>src/main/java</sourceFolder>
                    <dateLibrary>java8</dateLibrary>
                </configOptions>
            </configuration>
        </execution>
    </executions>
</plugin>

注意事项： #

• 确保构建环境（本地或CI/CD服务器）能够访问这个HTTP URL；
• 如果是内部私有服务，记得配置正确的认证头（比如上面示例中的Bearer Token）；
• 有些服务器可能会返回302重定向，插件会自动处理常规的重定向场景。

要让生成的代码始终和远程规范保持一致，你可以试试这些方法：

• 绑定生成到构建阶段：
  在插件的<execution>节点中添加<phase>generate-sources</phase>，这样每次执行mvn compile或mvn install时，插件都会自动拉取最新的规范并重新生成代码。示例：

  <execution>
      <phase>generate-sources</phase>
      <goals>
          <goal>generate</goal>
      </goals>
      <!-- 其他配置... -->
  </execution>
  

• 启用缓存优化：
  开启缓存后，插件会缓存下载的规范文件，只有当远程规范的ETag或Last-Modified头发生变化时，才会重新下载。既保证了代码和规范同步，又能提升构建速度。配置方式：

  <configuration>
      <cache>true</cache>
      <!-- 其他配置... -->
  </configuration>
  

• 添加规范验证步骤：
  可以配合openapi-validator-maven-plugin在生成代码前先验证远程规范的合法性，避免因规范错误生成无效代码。

如果你的API规范有版本迭代，可以将版本号嵌入到URL中（比如https://your-api-server.com/openapi/openapi-spec-v2.yaml），这样就能轻松切换不同版本的规范，同时保持对应版本代码的同步。

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