Flask应用报错AssertionError：视图函数映射覆盖现有端点index

错误详情 #

Traceback (most recent call last):
  File "C:\Users\Albert\PycharmProjects\Carro\views_trips.py", line 10, in <module>
    def index():
  File "C:\Users\Albert\PycharmProjects\Carro\venv\lib\site-packages\flask\scaffold.py", line 439, in decorator
    self.add_url_rule(rule, endpoint, f, **options)
  File "C:\Users\Albert\PycharmProjects\Carro\venv\lib\site-packages\flask\scaffold.py", line 57, in wrapper_func
    return f(self, *args, **kwargs)
  File "C:\Users\Albert\PycharmProjects\Carro\venv\lib\site-packages\flask\app.py", line 1090, in add_url_rule
    raise AssertionError(
AssertionError: View function mapping is overwriting an existing endpoint function: index

问题代码 #

当前定义的路由代码：

from flask import render_template, request, redirect, session, flash, url_for, send_from_directory
from app import app
from models import Trips, Users, Cars, db
import time
from helpers import *

from flask_bcrypt import check_password_hash

@app.route('/')
def index():
    nickname = 'Bertimaz'
    trip = Trips.query.filter_by(user_nickname=nickname).order_by(Trips.initialTime.desc()).first()
    user = Users.query.filter_by(nickname='Bertimaz')  # não ta achando usuario
    print(user.name)
    car = Cars.query.filter_by(plate=trip.car_plate)

    return render_template('home.html', titulo='Viagens', trip=trip, user=user, car=car)

注：引入SQLAlchemy模型前应用可正常运行，修改index函数名后问题仍未解决。

解决方案 #

• 检查视图文件重复导入：确认views_trips.py是否在启动文件（如app.py）中被多次导入（比如同时用了import views_trips和from views_trips import *），重复导入会导致Flask重复注册路由，引发endpoint冲突。
• 排查helpers模块：from helpers import *会导入模块内所有内容，检查helpers.py中是否存在同名的index函数或带@app.route装饰的函数，这类内容会意外注册重复路由。
• 检查模型文件的副作用：引入models后出现问题，查看models.py中是否误定义了@app.route装饰的函数，或是导入了其他视图代码，导致路由被重复注册。
• 显式指定唯一endpoint：如果必须保留同名函数，在路由装饰器中手动指定唯一的endpoint值：

  @app.route('/', endpoint='trips_index')
  def index():
      # 原有函数逻辑不变
  

• 检查应用实例重复初始化：确认app.py中是否多次创建了Flask实例，不同实例的路由注册可能引发冲突。

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