文章目录

• • • • 1. KeyError: 'A secret key is required to use CSRF.'
      • 2. flask KeyError: 'SQLALCHEMY_TRACK_MODIFICATIONS'
      • 3. UnicodeDecodeError: 'utf-8' codec can't decode byte 0xff in position 0: invalid start byte
      • 4. FSADeprecationWarning: SQLALCHEMY_TRACK_MODIFICATIONS adds significant overhead and will be disabled by default in the future. Set it to True or False to suppress this warning.
      • 5. sqlalchemy.exc.InvalidRequestError: Table 'user' is already defined for this MetaData instance. Specify 'extend_existing=True' to redefine options and columns on an existing Table object.
      • 6. Warning: (3719, "'utf8' is currently an alias for the character set UTF8MB3, but will be an alias for UTF8MB4 in a future release. Please consider using UTF8MB4 in order to be unambiguous.")
      • 7. sqlalchemy.exc.InternalError: (pymysql.err.InternalError) (3780, "Referencing column 'role_id' and referenced column 'id' in foreign key constraint 'admin_ibfk_1' are incompatible.")
      • 8. RuntimeError: No application found. Either work inside a view function or push an application context.
      • 9. ERROR [root] Error: Target database is not up to date.
      • 10. RuntimeError: No application found. Either work inside a view function or push an application context

1. KeyError: ‘A secret key is required to use CSRF.’

问题来源：提交 Form 表单时候报错
问题解析：报错的字面意思是使用CSRF需要密钥，说明我们适用CSRF的时候没有带密钥
解决方法：在实例化Flask之后配置上 SECRET_KEY 参数：

app = Flask(__name__)
app.config["SECRET_KEY"] = "12345678"

---

2. flask KeyError: ‘SQLALCHEMY_TRACK_MODIFICATIONS’

问题来源：提交 Form 表单时候报错
问题解析：博主安装的是当前日期最新版的Flask-SQLAlchemy：v2.4.3，很多人加入app.config["SQLALCHEMY_TRACK_MODIFICATIONS"] = True自然是解决不了问题的，说将Flask-SQLAlchemy降级规避也没有必要。报错的真正原因是models和views中的Flask实例对象时没有使用同一个Flask实例化，很多人实例化了两个Flask对象。注意即便使用同一个参数__name__来实例化Flask，得到的app对象也是不一样的，因为它们的内存地址不同。
解决方法：创建一个专门实例化Flask的Python文件，可以命名为create_app.py。models和views里都导入实例化好的app对象，那么它们使用的就是同一个Flask实例了。

from flask import Flaskapp = Flask(__name__)

---

3. UnicodeDecodeError: ‘utf-8’ codec can’t decode byte 0xff in position 0: invalid start byte

问题来源：生成验证码的时候读取图片报错
问题解析：读取图片使用了open(image_url)没有设置文件打开模式，使用了默认的只读模式
解决方法：图片是要以二进制方式读取，不需要设置编码。所以我们只需要设置打开模式为rb，即open(image_url,mode='rb')就可以了。

---

4. FSADeprecationWarning: SQLALCHEMY_TRACK_MODIFICATIONS adds significant overhead and will be disabled by default in the future. Set it to True or False to suppress this warning.

问题来源：使用SQLALCHEMY创建数据表
问题解析：字面意思是SQLALCHEMY_TRACK_MODIFICATIONS会增加大量开销，并且在将来默认情况下将被禁用。将其设置为True或False可取消显示此警告。
解决方法：根据字面意思将SQLALCHEMY_TRACK_MODIFICATIONS设置为True或False就可以了

from flask_sqlalchemy import SQLAlchemy  # pip install flask_sqlalchemyfrom create_app import appapp.config["SQLALCHEMY_DATABASE_URI"] = "mysql+pymysql://root:123456@localhost:3306/article_cms"
app.config["SQLALCHEMY_TRACK_MODIFICATIONS"] = True

---

5. sqlalchemy.exc.InvalidRequestError: Table ‘user’ is already defined for this MetaData instance. Specify ‘extend_existing=True’ to redefine options and columns on an existing Table object.

问题来源：使用SQLALCHEMY创建数据表
问题解析：字面意思让我们指定“extend_existing=True”以重新定义现有表对象上的选项和列。
解决方法：根据字面意思操作就可以

class User(db.Model):__tablename__ = "user"__table_args__ = {'extend_existing': True}

---

6. Warning: (3719, “‘utf8’ is currently an alias for the character set UTF8MB3, but will be an alias for UTF8MB4 in a future release. Please consider using UTF8MB4 in order to be unambiguous.”)

问题来源：使用SQLALCHEMY创建数据表
问题解析：字面意思是以后的编码应该使用UTF8MB4，我们连接的时候指定的编码写的utf8是UTF8MB3的别名。（博主使用的是MySQL8.0，新版的数据库）
解决方法：网上很多说创建数据库的时候指定编码是UTF8MB4，博主也试了，但是还是报这样的警告。最合适的解决方法是连接数据库的时候指定编码UTF8MB4，示例如下：

app.config["SQLALCHEMY_DATABASE_URI"] = "mysql+pymysql://root:123456@localhost:3306/lsqz?charset=utf8mb4"

---

7. sqlalchemy.exc.InternalError: (pymysql.err.InternalError) (3780, “Referencing column ‘role_id’ and referenced column ‘id’ in foreign key constraint ‘admin_ibfk_1’ are incompatible.”)

问题来源：使用SQLALCHEMY创建数据表
问题解析：字面意思是外键约束'admin_ibfk_1'中的引用列'role_id'和引用列'id'不兼容，应该是两个列的数据类型不同导致不兼容的
解决方法：role_id和id列设置为相同的数据类型

class Admin(db.Model):...role_id = db.Column(db.Integer, db.ForeignKey('role.id')) # 都应该是Integer...class Role(db.Model):...id = db.Column(db.Integer, primary_key=True)  # 都应该是Integer...

---

8. RuntimeError: No application found. Either work inside a view function or push an application context.

问题来源：执行db.create_all()的时候报错
问题解析：没有找到app，不能在没有app上下文的环境下使用
解决方法：db.create_all()会到应用上下文中找app，找到后再去app中找配置文件，然后帮助我们生成表。在使用db.create_all()之前必须先把app和g封装成AppContext对象，然后放到Local中。

from app import db, create_appapp = create_app()
app_ctx = app.app_context()
with app_ctx:db.create_all()

---

9. ERROR [root] Error: Target database is not up to date.

报错提示信息：

INFO  [alembic.runtime.migration] Context impl MySQLImpl.
INFO  [alembic.runtime.migration] Will assume non-transactional DDL.
ERROR [root] Error: Target database is not up to date.

问题来源：更新数据表结构，做数据迁移
问题解析：版本号的问题，migrate命令执行后生成新的版本号与数据库的版本号不一致
解决方法：将表alembic中的版本号修改为migrate命令执行后生成新的版本号，然后再执行migrate和upgrade。

---

10. RuntimeError: No application found. Either work inside a view function or push an application context

问题来源：在views以及forms的全局作用域中使用从models中导入的类时报错

views.py:

from .. import admin
from ..forms.role_form import RoleForm
from flask import render_template
from ...models import Authauth_list = Auth.query.all()
<hr># 添加角色
@admin.route("/admin/role/add/", methods=["GET", "POST"])
def role_add():form = RoleForm()return render_template('admin/role_add.html', form=form)

forms.py:

from flask_wtf import FlaskForm
from wtforms import StringField, SubmitField, SelectMultipleField
from wtforms.validators import DataRequired
from ...models import Authauth_list = Auth.query.all()class RoleForm(FlaskForm):auths = SelectMultipleField(label="操作权限",validators=[DataRequired("请选择操作权限！")],coerce=int,choices=[(v.id, v.name) for v in auth_list],description="操作权限",render_kw={"class": "form-control",})

问题解析：报错提示的意思是：找不到应用程序，要么在视图函数中工作，要么push应用程序上下文。
解决方法：很明显在视图中工作满足不了我们的需求了，所以我们选择push应用程序上下文。在实例化app对象之后push应用程序上下文 app.app_context().push():

__init__.py:

from flask import Flask, render_template
from flask_session import Sessionfrom flask_sqlalchemy import SQLAlchemydb = SQLAlchemy()# from .models import *
from app import modelsapp = Flask(__name__)
app.app_context().push()
app.config.from_object('settings.DevelopmentConfig')
Session(app)
# 缺少数据库连接，把数据库连接配置传到sqlalchemy，
db.init_app(app)  # init_app方法源码可以查看已有的配置
"""
必须在app对象创建完成后才可以导入蓝图，否则在蓝图中使用app对象需要导入app对象时循环导入
"""
from app.admin import admin as admin_blueprint
from app.home import home as home_blueprintapp.register_blueprint(admin_blueprint)
app.register_blueprint(home_blueprint)