Flask-Smorest蓝图重复注册报错：'Items'已注册求助

核心原因 #

这个错误是因为同一个蓝图（Blueprint）下注册了两个同名的资源，Flask-Smorest默认用资源类名作为资源的唯一标识，当重复出现同名标识时就会触发该报错。

排查与修复步骤 #

1. 检查资源类的重复定义/注册 #

打开item.py，确认是否存在以下情况：

• 两个完全同名的Items资源类，都通过@blp.route()装饰器注册到了同一个蓝图
• 同一个Items类被多次用@blp.route()装饰（比如同时绑定列表路由和详情路由，但未指定唯一名称）

错误示例：

# item.py 错误写法
from flask_smorest import Blueprint
from flask.views import MethodView

blp = Blueprint("items", __name__)

@blp.route("/items")
class Items(MethodView):
    def get(self):
        return {"items": []}

# 重复定义同名类并注册
@blp.route("/items/<int:item_id>")
class Items(MethodView):
    def get(self, item_id):
        return {"item_id": item_id}

修复方式：
要么给第二个资源类重命名，要么在注册时显式指定唯一的name参数：

# 方式1：重命名类
@blp.route("/items/<int:item_id>")
class ItemDetail(MethodView):
    def get(self, item_id):
        return {"item_id": item_id}

# 方式2：指定唯一name参数
@blp.route("/items/<int:item_id>", name="ItemById")
class Items(MethodView):
    def get(self, item_id):
        return {"item_id": item_id}

2. 检查蓝图的重复注册 #

打开app.py，确认是否多次调用app.register_blueprint()注册同一个items蓝图：
错误示例：

# app.py 错误写法
from item import blp as items_blp

app.register_blueprint(items_blp)
app.register_blueprint(items_blp)  # 重复注册同一蓝图

修复方式：删除重复的register_blueprint调用，确保每个蓝图只注册一次。

3. 检查跨文件的资源名称冲突 #

打开store.py，确认是否存在以下情况：

• 创建了和item.py同名的蓝图（比如blp = Blueprint("items", __name__)）
• 在该蓝图下也注册了名为Items的资源类

修复方式：

• 给不同功能的蓝图设置不同名称（比如store.py里用blp = Blueprint("stores", __name__)）
• 或者给冲突的资源类指定唯一的name参数

快速兜底修复 #

如果暂时找不到重复点，可以给所有资源注册都显式添加唯一name参数，强制覆盖默认的类名标识：

# item.py 示例
@blp.route("/items", name="ItemsList")
class Items(MethodView):
    def get(self):
        # 业务逻辑

@blp.route("/items/<int:item_id>", name="ItemDetail")
class Items(MethodView):
    def get(self, item_id):
        # 业务逻辑

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