在 connexion 中链接 yaml 文件时出错

Question

我正在开发自定义微服务，它将对 Web 服务进行某种身份验证。微服务正在使用 flask、swagger 和 connexion 进行开发。由于 swagger.yaml 文件变得很大（由于 url 的加载）以降低文件的复杂性，我试图将其分解。

W/D
├── paths
│   └── users.yml
├── server.sh
├── src
│   ...
└── swagger.yml

在主要的 swagger 文件中，我尝试通过

link users.yml 和 swagger.yml

paths:
  /users:
    $ref: ./paths/users.yml

所以当我 运行 项目时，它给了我这个错误..

jsonschema.exceptions.RefResolutionError: unknown url type: './paths/users.yml'

这可能是什么原因？这个问题是因为 connexion 吗？

Answer 1

Connexion https://github.com/zalando/connexion/issues/254 目前不支持拆分 swagger 文件。 https://github.com/zalando/connexion/issues/254#issuecomment-497194240 您可以使用 prance 将单独的 OpenAPI 文件合并为一个文件，然后再将其输入连接。