Flask项目用Insomnia/Postman请求时出现user table not found错误

本人对Flask不太熟悉，当前遇到一个问题：使用Insomnia或Postman向localhost:5000发送注册POST请求时，提示“user table not found”，但项目能正常启动，单元测试可以完成注册并获取token，之前功能正常，几乎没修改相关代码。已尝试卸载重装SQLAlchemy和Flask-SQLAlchemy，也试过以管理员身份运行VS Code和Insomnia，问题仍未解决。

相关代码 #

models.py中的User模型 #

from flask_sqlalchemy import SQLAlchemy

db = SQLAlchemy()


"""
class User:
    id:integer
    username:string
    email:string
    password:string
"""

class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(25),nullable=False,unique=True)
    email = db.Column(db.String(80),nullable=False)
    password = db.Column(db.Text(),nullable=False)

    def __repr__(self):
        return f"<User {self.username}>"
    
    def save(self):
        db.session.add(self)
        db.session.commit()

注册接口代码 #

from flask import Flask, request, jsonify, make_response
from flask_restx import Resource, Namespace, fields
from models import User
from werkzeug.security import generate_password_hash, check_password_hash
from flask_jwt_extended import (JWTManager, create_access_token, create_refresh_token, jwt_required, get_jwt_identity)


auth_ns=Namespace('auth', description='Authentication related operations')


signup_model=auth_ns.model(
    'SignUp',
    {
        "username": fields.String(),
        "email": fields.String(),
        "password": fields.String()   
    }
)


@auth_ns.route('/signup')
class SignUp(Resource):
    @auth_ns.expect(signup_model, validate=True)
    def post(self):
        data=request.get_json()
        
        username=data.get('username')
        
        db_user=User.query.filter_by(username=username).first()

        if db_user is not None:
            message_error='Username already exists'
            return message_error, 400
        
        new_user=User(
            username=data.get('username'),
            email=data.get('email'),
            password=generate_password_hash(data.get('password'))
        )
        
        new_user.save()


        return make_response(jsonify({"message": "User created successfully"}),201)

单元测试代码 #

class APITestCase(unittest.TestCase):
    def setUp(self):
        self.app = create_app(TestConfig)
        self.client = self.app.test_client(self)

        with self.app.app_context():
            # db.init_app(self.app)

            db.create_all()

    def test_signup(self):
        signup_response = self.client.post(
            '/auth/signup',
            json={
                "username": "testuser",
                "email": "test@email.com",
                "password": "password"
            }
        )

        status_code = signup_response.status_code

        self.assertEqual(status_code, 201)
        
    def tearDown(self):
        with self.app.app_context():
            db.session.remove()
            db.drop_all()

if __name__ == '__main__':
    unittest.main()   

请求参数示例 #

{
    "username":"testman",
    "email":"test@gmail.com",
    "password":"password"
}

预期正常返回结果 #

{'message': 'User created successfully'}

排查与解决方案 #

1. 确认生产环境数据库是否初始化 #

单元测试中通过db.create_all()创建了表，但实际运行项目时，可能没有执行初始化操作：

• 启动项目前，在Flask shell中执行以下命令创建表：

from your_app_module import app, db
with app.app_context():
    db.create_all()

或者在项目启动文件中添加初始化逻辑（仅首次运行）：

if __name__ == '__main__':
    with app.app_context():
        db.create_all()
    app.run(debug=True)

2. 检查数据库配置是否一致 #

单元测试使用TestConfig，而实际运行可能使用不同的配置文件，导致连接的数据库不是同一个（比如测试用SQLite内存库，生产用本地文件库或其他数据库）：

• 确认项目运行时的SQLALCHEMY_DATABASE_URI配置，确保和测试环境的目标数据库一致，或者手动在对应数据库中创建User表。

3. 确认数据库初始化逻辑 #

检查项目启动文件中是否正确初始化数据库：

• 确保db.init_app(app)被正确调用，且所有数据库操作都在app.app_context()环境下执行。

4. 查看数据库实际状态 #

直接连接到项目使用的数据库，查看是否存在user表（Flask-SQLAlchemy默认使用小写表名，除非自定义了表名）。如果不存在，手动创建或执行db.create_all()完成初始化。

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