介绍
Flask-RESTful 是一个基于 Flask 的 RESTful 框架，可以帮助我们快速地搭建 RESTful API。而 Swagger-UI 则是一个可以生成 API 文档的工具，它可以让我们更方便地测试和使用 API。
但是在使用 Flask-RESTful 和 Swagger-UI 的过程中，可能会遇到一些兼容性问题。本篇文章将介绍如何解决这些问题，以便让我们更顺畅地使用这两个工具。
问题描述
在使用 Flask-RESTful 和 Swagger-UI 的过程中，可能遇到以下两个问题：
Swagger-UI 无法正确解析 Flask-RESTful 的参数类型和默认值。
Swagger-UI 显示的 API 地址不正确。
这两个问题都与 Flask-RESTful 和 Swagger-UI 的参数解析机制有关。
解决方案
问题一：解析参数类型和默认值
Flask-RESTful 使用了一个名为 marshal_with 的装饰器来指定返回值的格式，并可以自动将请求参数转换为相应的数据类型。而 Swagger-UI 使用了 OpenAPI 规范来解析 API 的参数和返回值。
为了让 Swagger-UI 能够正确解析 Flask-RESTful 的参数类型和默认值，我们需要将 Flask-RESTful 的参数类型转换为 OpenAPI 规范中的数据类型。
下面是一个示例代码：
-- -------------------- ---- -------
---- ------------- ------ --------- ------------
---- -------------------- ------ -------- ------
- -------
--------------- - -
------- -------
------ -------------------
-
----- -----------------------
------------------------------
--- --------- ---------
- -----------
---- - -
------- -----
------ --
-
- ------
------ ----在上面的代码中，我们使用了 String 和 Integer 类型来定义返回值的格式，同时使用了 default 参数来指定默认值。
为了让 Swagger-UI 能够正确解析这个 API，我们需要将 String 和 Integer 类型转换为 OpenAPI 规范中的类型。
具体地，我们需要将 String 类型转换为 "type": "string"，将 Integer 类型转换为 "type": "integer"，并在 "integer" 中添加 "default" 属性来指定默认值。
下面是转换后的代码：
-- -------------------- ---- -------
---- ----------------------- ------ ------
---- ------------------------------ ------ -------- ------
----- -------------------
---- - --------
---------- - -
------- -------
------ ----------------------- -----------
-
----- -----------------------
-------------------------- ----- ----- ---- ---- ---------
------------------------------------ ---------------------- ------------------
--- --------- ---------
- -----------
---- - -
------- -----
------ --
-
- ------
------ ----在上面的代码中，我们使用了 flask_restful_swagger_2 模块中的 Schema 类来定义返回值的格式，并使用了 Integer 和 String 类型来定义数据类型，同时在 Integer 中添加了 format 和 default 属性。
问题二：修正 API 地址
Flask-RESTful 默认会注册一个以 /api/ 开头的 URL 前缀，而 Swagger-UI 使用了 Flask-RESTful 的路由表来生成 API 文档。这就导致 Swagger-UI 显示的 API 地址与实际的 API 地址不一致。
为了修正这个问题，我们需要在 Swagger-UI 中手动指定 API 地址：
-- -------------------- ---- -------
---- ----- ------ -----
---- ------------- ------ ---
---- -------- ------ -------
--- - ---------------
--- - -------- --------------
------- - ------------ ---------------------------- --------
---------- ------
------- ----------------- - -- --- --
----------- ------
--在上面的代码中，我们手动指定了 API 地址为 localhost:5000，这样 Swagger-UI 显示的 API 地址就和实际的 API 地址一致了。
总结
本篇文章介绍了在使用 Flask-RESTful 和 Swagger-UI 的过程中可能遇到的兼容性问题，并给出了解决方案。同时我们也介绍了如何手动指定 API 地址，修正 Swagger-UI 显示的 API 地址与实际的 API 地址不一致的问题。相信本篇文章能够对需要搭建 RESTful API 的开发者们有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64af53d448841e9894b5bc1c