如何在Flask导航栏中配置可部署的自动生成Swagger文档链接？

flask_smorest生成的Swagger UI页面是通过静态路由注册的，没有对应的Flask视图函数端点（即View组件所需的端点名称），因此不能用View添加该导航项，需改用Link组件并指定相对路径：

修改后的代码如下：

nav = Nav(app)
bootstrap = Bootstrap(app)
topbar = Navbar(
    View('Home', 'main.index'),
    View('Nodes', 'nodes.index'),
    Link('GitHub', 'https://github.com/somepage'),
    Link('Swagger Docs', '/openapi/swagger-ui')  # 替换为Link组件，使用相对路径
)

核心说明 #

• 采用相对路径/openapi/swagger-ui而非硬编码localhost:5000/...，确保部署到任意域名或端口时，链接都能正确指向Swagger文档页面。
• View仅适用于映射自定义的Flask视图函数（对应@app.route或蓝图路由的端点），而flask_smorest的Swagger路由由扩展自动注册，未暴露端点名称，因此必须用Link直接指定URL路径。

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