使用pytest测试Flask应用时请求对象缺失端口致404问题

问题根源 #

测试返回404的核心原因有两个：

• 测试环境的app实例未加载index.py中注册的路由：路由绑定在database.py的app上，但测试代码仅导入了app，未触发index.py执行，导致路由未注册。
• conftest.py的app导入路径错误：database.py位于api目录下，测试文件在api/tests内，直接from database import app会找不到模块。

具体修复步骤 #

1. 修正conftest.py的导入逻辑 #

修改api/tests/conftest.py，确保导入正确的app并触发路由注册：

import pytest
# 正确导入api目录下的database模块
from api.database import app
# 导入index.py，触发路由绑定到app实例
import api.index

@pytest.fixture()
def client():
    with app.test_client() as client:
        yield client

2. 修复index.py的缺失导入 #

index.py中使用了render_template但未导入，补充后避免运行报错：

from flask import request, render_template

from api.database import app

@app.route("/")
def home():
    if request.method == "GET":
        return render_template("index.html")

3. 确保在项目根目录运行测试 #

打开终端切换到项目根目录（包含index.py和api文件夹的目录），执行测试命令：

pytest

此操作能让Python正确识别api作为模块，避免导入路径错误。

额外说明 #

• 响应中显示的http://localhost/是test_client的默认请求地址，端口不影响路由匹配，404与端口无关。
• 无需重构为app factory模式，上述修改完全适配你已部署到Vercel的现有代码结构。

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