Flask蓝图多路由index函数断言错误问题咨询

我正在创建基于蓝图结构的Flask应用，在main和transcriptApi两个不同路由文件夹中各定义了一个index视图函数。尽管已将蓝图映射至不同URL前缀，但仍触发断言错误：

AssertionError: View function mapping is overwriting an existing endpoint function: index

项目文件结构大致如下：

• 项目根目录
  • main/
    • init.py
    • routes.py（包含main蓝图的index视图）
  • transcriptApi/
    • init.py
    • routes.py（包含transcriptApi蓝图的index视图）
  • app.py（负责注册所有蓝图的主文件）

这个错误的核心原因是：Flask 默认使用视图函数的名称作为端点（endpoint）的标识，和蓝图挂载的URL前缀无关。两个蓝图里的index视图函数会被自动分配同一个端点名称index，导致路由映射冲突。

你可以通过以下两种方式解决：

• 给蓝图添加端点前缀
  在注册蓝图时，通过endpoint_prefix参数为蓝图下的所有端点统一添加前缀，确保端点名称唯一：

  # app.py 中的蓝图注册代码
  from main.routes import main_bp
  from transcriptApi.routes import transcript_api_bp
  
  app.register_blueprint(main_bp, url_prefix='/', endpoint_prefix='main_')
  app.register_blueprint(transcript_api_bp, url_prefix='/transcript', endpoint_prefix='transcript_')
  

  这样两个index视图的端点会被分别命名为main_index和transcript_index，不会再出现冲突。

• 给单个视图指定端点名称
  在定义视图函数时，通过route装饰器的endpoint参数显式设置唯一的端点名：

  # main/routes.py
  @main_bp.route('/', endpoint='main_index')
  def index():
      return "主页面"
  
  # transcriptApi/routes.py
  @transcript_api_bp.route('/', endpoint='transcript_index')
  def index():
      return "转录接口首页"
  

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