使用pytest测试Flask应用时路由返回404问题求助

核心问题原因 #

你的/login路由是注册在全局app实例（即app = create_app()创建的实例）上的，但测试代码中通过create_app(TestingConfig)创建了一个全新的Flask实例——这个新实例并没有加载任何自定义路由，只有默认的静态路由，因此访问/login会返回404。

解决方案 #

需要确保路由注册逻辑绑定到create_app函数内创建的app实例上，有两种常用方式：

方式1：将路由直接移到create_app函数内部 #

修改app.py，把路由定义放在create_app函数里，让每次创建app实例时都注册路由：

def create_app(config_class=DevelopmentConfig):
    app = Flask(__name__)
    app.config.from_object(config_class)
    app.config['SQLALCHEMY_DATABASE_URI'] = config_class.SQLALCHEMY_DATABASE_URI
    app.config['SECRET_KEY'] = 'your_secret_key'

    # Initialize extensions with the app
    db.init_app(app)
    migrate.init_app(app, db)

    # 路由注册绑定到当前创建的app实例
    @app.route('/login', methods=['GET', 'POST'])
    def login():
        # Route implementation
        return render_template('login.html')

    return app

# 全局实例仅用于非测试环境启动应用
app = create_app()

方式2：使用Blueprint管理路由（推荐，适合多路由场景） #

如果你的应用有多个路由，用蓝图（Blueprint）更便于模块化管理：

1. 在app.py中定义蓝图并注册路由：

from flask import Blueprint, render_template

# 创建蓝图
auth_bp = Blueprint('auth', __name__)

# 路由绑定到蓝图
@auth_bp.route('/login', methods=['GET', 'POST'])
def login():
    # Route implementation
    return render_template('login.html')

def create_app(config_class=DevelopmentConfig):
    app = Flask(__name__)
    app.config.from_object(config_class)
    app.config['SQLALCHEMY_DATABASE_URI'] = config_class.SQLALCHEMY_DATABASE_URI
    app.config['SECRET_KEY'] = 'your_secret_key'

    db.init_app(app)
    migrate.init_app(app, db)

    # 注册蓝图到app实例
    app.register_blueprint(auth_bp)

    return app

app = create_app()

验证修改 #

修改完成后，重新运行测试：

• 测试中的create_app(TestingConfig)会生成包含/login路由的实例
• 调用client.get('/login')将返回200状态码，断言通过

额外排查思路 #

• 打印测试用app实例的url_map：在fixture中添加print(app.url_map)，确认自定义路由是否已注册
• 检查装饰器绑定对象：确保路由装饰器（@app.route或@blueprint.route）绑定的是当前创建的app/蓝图实例，而非全局实例
• 确认应用上下文：测试中已正确使用app.app_context()，但路由未注册的问题本质是实例绑定错误，与上下文无关

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