Flask-RESTX中SwaggerUI静态资源的自定义URL前缀访问配置

当前所有前端路径渲染拼接逻辑已经正确，Flask应用未注册/my-prefix/swaggerui/路径下的静态资源响应规则，导致对应请求404，需补充以下配置：

注册带前缀的Swagger静态资源路由 #

Flask-RESTX自带的SwaggerUI静态文件默认存储在包内置的static目录下，未绑定到你自定义的/my-prefix/swaggerui/访问路径，需手动添加路由映射：

import os
from flask import send_from_directory
import flask_restx

# 定位flask_restx包内置的SwaggerUI静态文件根目录
SWAGGER_STATIC_DIR = os.path.join(os.path.dirname(flask_restx.__file__), "static")

# 注册带my-prefix前缀的静态资源访问规则
@app.route("/my-prefix/swaggerui/<path:filename>")
def get_swagger_static(filename):
    return send_from_directory(SWAGGER_STATIC_DIR, filename)

路由参数必须使用<path:filename>转换器，否则无法匹配SwaggerUI静态资源里嵌套子路径的文件。

修正模板全局函数的注册逻辑 #

你之前写的@apidoc.apidoc.add_app_template_global存在未定义变量引用的问题，正确的注册方式是直接和已初始化的Api实例绑定：

def swagger_static(filename):
    return f"/my-prefix/swaggerui/{filename}"

# 注册为Swagger模板的全局可调用方法
api.add_app_template_global(swagger_static, name="swagger_static")

排查要点 #

• 自定义文档页面的逻辑无需单独引入外部swagger-ui.html模板，Flask-RESTX内置模板已完成所有渲染逻辑，@api.documentation装饰器下的方法只要传入正确的标题、specs_url参数即可正常运行。
• 生产反向代理配置需确保所有带/my-prefix前缀的请求（含接口、文档页面、swagger.json、swaggerui静态资源）全部转发到Flask应用进程，不要在代理层将swaggerui路径识别为本地静态文件直接返回。
• 静态资源路由的注册顺序需放在Api实例初始化完成之后，避免被其他全局路径拦截规则提前匹配返回404。

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