Windows下OpenAPI Generator Gradle插件inputSpec配置问题求助

针对你遇到的Windows机器上OpenAPI Generator Gradle插件inputSpec路径配置错误，以下是几种可靠的解决方案：

1. 使用Gradle file()方法（最推荐） #

Gradle的file()方法会自动适配Windows的路径分隔符，并且基于项目根目录解析文件路径，彻底避免路径格式问题。配置如下：

openApiValidate {
    inputSpec = file("src/main/resources/api/openapi.yaml").absolutePath
}

原理：file()方法会将相对路径转换为当前项目下的绝对文件路径，生成符合Windows格式的字符串，同时避开URI格式冲突问题。

2. 基于Gradle Project Layout API（Gradle 7+ 推荐） #

如果你使用Gradle 7及以上版本，建议使用官方推荐的Project Layout API来获取文件路径，更符合Gradle的最佳实践：

openApiValidate {
    inputSpec = project.layout.projectDirectory
        .file("src/main/resources/api/openapi.yaml")
        .get()
        .asFile
        .absolutePath
}

原理：该API会安全地处理跨平台路径，确保生成的路径格式完全兼容当前系统。

错误原因分析 #

你之前遇到的各种报错对应以下原因：

• 相对路径直接报错：插件默认会在classpath中查找文件，而非项目的本地文件系统，因此找不到指定文件。
• $projectDir拼接报错：Windows路径中的冒号（:）和反斜杠（\）不符合URI语法规范，导致Java抛出URISyntaxException。
• 类Unix绝对路径报错：插件将该路径识别为相对路径，自动拼接到项目根目录后，导致路径重复。

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