Json swagger codegen:java.io.FileNotFoundException:无法读取API

我正在尝试使用

swagger codegen

根据我的swagger资源文件生成代码。但是，我在尝试生成代码时遇到以下错误：

base path is http://my.documentation.com/api/docs/v1.json
java.io.FileNotFoundException: http://my.documentation.com/api/docs/v1.json/authenticateUser

似乎，

swagger codegen

试图通过在

v1.json

之后添加操作名来读取方法定义，但我不确定原因，因为操作名是在

v1.json

本身中定义的：

{
    "basePath":"https://my.api.com/v1",
    "swaggerVersion":"1.2",
    "apiVersion":"1.0.0",
    "resourcePath":"v1",
    "apis":[
        {
            "path":"/authenticateUser",
            "description":"Authenticates a user into the API",
            "operations":[
                {
                    "method":"GET",
                    "summary":"Authenticates a user into the API",
                    "nickname":"authenticateUser",
                    "parameters":[
                        {
                            "paramType":"query",
                            "name":"username",
                            "type":"string",
                            "required":true,
                            "description":"Name of of user to authenticate"
                        },
                        {
                            "paramType":"query",
                            "name":"password",
                            "type":"string",
                            "required":true,
                            "description":"User's password"
                        }
                    ],
                    "notes":"Returns access token in the response object"
                }
            ]
        },
    ...
    ]
}

我不完全确定所期望的是什么格式

swagger-codegen

。API的基本路径和API的文档是否需要相同？请注意，文档的文档托管在一个独立的basePath上，而不是API本身。我不确定这是否重要

---

我还将注意到，我的swagger资源文件

v1.json

是使用

swagger php

生成的，并且在

swagger ui

中将基本路径更改为

http://my.documentation.com/api/docs/

而不是

http://my.documentation.com/api/docs/v1.json

解决了问题。

它出现了需要将文档基本路径设置为

http://my.documentation.com/api/docs/

。这解决了问题。