如何在Flask-RESTX中实现无命名空间的旧版API兼容？

方案一：复用视图函数，给旧版Api实例添加独立端点 #

你当前的旧版Api实例因添加了带/art路径的art_ns，导致旧URL变成/art/savegallery，不符合需求。可以直接把art_ns里的/savegallery视图函数单独提取，注册到旧版Api实例的根路径下：

在/app/api/__init__.py中修改：

from flask_restx import Api
from app.art.routes import art_ns, SaveGallery  # 导入命名空间和视图类

# 新版Api实例（对应/api/v1前缀的Blueprint）
api_v1 = Api(
    title='新版API',
    version='1.0'
)
api_v1.add_namespace(art_ns)

# 旧版Api实例（对应无前缀的Blueprint）
api_old = Api(
    title='旧版兼容API',
    version='1.0'
)
# 直接添加无命名空间的/savegallery端点，复用原视图逻辑
api_old.add_resource(SaveGallery, '/savegallery')

对应的app/art/routes.py需要暴露视图类：

from flask_restx import Namespace, Resource

art_ns = Namespace('art', path='/art')

class SaveGallery(Resource):
    def post(self):
        # 原有业务逻辑代码
        return {'message': 'gallery saved'}

# 暴露视图类供旧版Api调用
art_ns.add_resource(SaveGallery, '/savegallery')

方案二：Flask原生路由重定向（适合引导用户切换到新版URL） #

如果无需旧版URL处理业务，仅做跳转，可以直接在旧版Blueprint中添加重定向路由，无需依赖Flask-RESTX的Api实例：

在app/__init__.py中修改：

from flask import Blueprint, redirect, url_for, request

# 旧版无前缀Blueprint
old_bp = Blueprint('old_api', __name__)

# 重定向/savegallery到新版对应端点
@old_bp.route('/savegallery', methods=['GET', 'POST'])
def redirect_savegallery():
    # POST请求用307（保留请求方法和体），GET请求用301（永久重定向）
    status_code = 307 if request.method == 'POST' else 301
    # api_v1.art_savegallery是Flask-RESTX自动生成的视图名称，格式为{命名空间名}_{端点名}
    return redirect(url_for('api_v1.art_savegallery'), code=status_code)

# 注册Blueprint
app.register_blueprint(old_bp)
app.register_blueprint(api_v1_bp, url_prefix='/api/v1')  # 新版Blueprint

方案三：覆盖旧版Api实例的命名空间路径 #

如果需要复用命名空间内的所有旧版端点，仅去掉/art前缀，可以在添加命名空间到旧版Api时覆盖路径：

在/app/api/__init__.py中：

from flask_restx import Api
from app.art.routes import art_ns

# 新版Api实例
api_v1 = Api(title='新版API', version='1.0')
api_v1.add_namespace(art_ns)

# 旧版Api实例
api_old = Api(title='旧版兼容API', version='1.0')
# 添加命名空间时将路径设为空字符串，去掉/art前缀
api_old.add_namespace(art_ns, path='')

此方案会让art_ns内的所有端点都映射到旧版根路径下，需确认是否符合所有旧版URL的规则。

内容的提问来源于stack exchange，提问作者Efraín