[BUG] [Spring Boot] [Maven plugin] OpenAPI Generator 7.4.0 can't read OpenAPI 3.1 spec on Windows.

[TheArcaneBrony]

Bug Report Checklist

• Have you provided a full/minimal spec to reproduce the issue?
• Have you validated the input using an OpenAPI validator (example)?
• Have you tested with the latest master to confirm the issue still exists?
• Have you searched for related issues/PRs?
• What's the actual output vs expected output?
• [Optional] Sponsorship to speed up the bug fix or feature request (example)

Description

I tried upgrading an OpenAPI spec from 3.0.0 to 3.1.0, when I tried to generate the DTOs I need, the console is spammed with:

[ERROR] Error resolving schema #/components/schemas/SomeDTO
java.net.URISyntaxException: Illegal character in opaque part at index 2: C:\workspaces\.../src/main/resources/openapi.yaml
...
at io.swagger.v3.parser.reference.ReferenceUtils.resolve (ReferenceUtils.java:29)

This only appears to happen under Windows, while I can't reproduce this under WSL.

openapi-generator version

7.4.0

OpenAPI declaration file content or url

I don't have access to GitHub on the machine I can reproduce this on, though I'd assume this can be reproduced by any flat (single file) YAML OpenAPI document that uses $ref to refer to schemas or parameters.

Generation Details

This is a summary of relevant settings.

• generator: spring
• generateApiTests: false
• generateModelTests: false
• interfaceOnly: true
• useJakartaEe: true
• async: false

Steps to reproduce

Create OpenAPI spec of version 3.1
Add some model references using $ref: '#/components/schemas/MyDTO'
Attempt to generate (possibly with the maven plugin)

Related issues/PRs

None that I could find.

Suggest a fix

[wing328]

This only appears to happen under Windows, while I can't reproduce this under WSL.

looks like an issue with swagger parser

please report the issue to https://github.com/swagger-api/swagger-parser

as a workaround, please use WSL for the time being

[WiredNerd]

On version 7.6.0, it appears to be only a problem in validation. When I run with true it generates the code successfully.

[TimmFitschen]

Same problem here, tried version 7.3.0 and 7.6.0. None of the proposed workarounds worked for me. But I figured I have to get rid of the "C:" because that is not URI compliant. So I changed location of the yaml file in the pom.xml:

             </goals>
             <id>buildApi</id>
             <configuration>
-              <inputSpec>${basedir}/src/main/resources/api.yaml</inputSpec>
+              <inputSpec>api/src/main/resources/api.yaml</inputSpec>
               <generatorName>spring</generatorName>
               <!--<library>spring-boot</library>-->
               <modelNameSuffix/>

That did the trick, now its generating...

Note: I have the api generation in a "api" maven sub module...

[gexclaude]

we got the issue that we develop on windows but CI/CD runs on linux.
on root level we got a parent pom and an "api" submodule. We basically needed to make use of profiles to get a configuration that runs on windows and linux.

it might help some of you.

<profiles>
    <profile>
        <id>windows</id>
        <activation>
            <os>
                <family>Windows</family>
            </os>
        </activation>
        <properties>
            <os.name>Windows</os.name>
        </properties>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.openapitools</groupId>
                    <artifactId>openapi-generator-maven-plugin</artifactId>
                    <version>7.9.0</version>
                    <executions>
                        <execution>
                            <goals>
                                <goal>generate</goal>
                            </goals>
                            <configuration>
                                <inputSpec>api/src/main/resources/oas-3.1.yaml</inputSpec>
                                <!-- further config omitted -->
                            </configuration>
                        </execution>
                    </executions>
                </plugin>
            </plugins>
        </build>
    </profile>
    <profile>
        <id>linux</id>
        <activation>
            <os>
                <family>unix</family>
            </os>
            <property>
                <name>!windows.profile.active</name>
            </property>
        </activation>
        <properties>
            <os.name>Linux</os.name>
        </properties>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.openapitools</groupId>
                    <artifactId>openapi-generator-maven-plugin</artifactId>
                    <version>7.9.0</version>
                    <executions>
                        <execution>
                            <goals>
                                <goal>generate</goal>
                            </goals>
                            <configuration>
                                <inputSpec>${basedir}/src/main/resources/oas-3.1.yaml</inputSpec>
                                <!-- further config omitted -->
                            </configuration>
                        </execution>
                    </executions>
                </plugin>
            </plugins>
        </build>
    </profile>
</profiles>

[gexclaude]

I raised a new issue for swagger-parser in order to check, if it is really a bug in swagger-parser or not.
swagger-api/swagger-parser#2136

[Saljack]

There is no solution for a multimodule project. You have to decide if you want to build all modules (by their root module) or one by one.