如何修复Flask图书管理项目中SQLAlchemy抛出的InterfaceError错误

这个报错不是SQL代码本身的问题，是你传入的参数值类型和数据库表定义的字段类型不匹配，一共有两个核心错误点：

• 参数3对应ISBN字段：表单提交的是Decimal类型，而数据库定义的ISBN_num是Integer类型，SQLite不支持直接转换，且13位ISBN超出普通Integer存储上限会溢出
• img字段：你直接把Flask上传生成的FileStorage对象存入了定义为String类型的img字段，类型完全不匹配

1. 修正ISBN字段定义 #

首先修改Book模型的ISBN字段类型，改为字符串类型更符合ISBN的存储需求：

class Book(db.Model):
    # 其他字段不变
    ISBN_num = db.Column(db.String(20), unique=True, nullable=False)

然后修改表单里的ISBN字段类型，从DecimalField改为StringField：

class BookForm(FlaskForm):
    # 其他字段不变
    ISBN_num = StringField("The ISBN-13 number", validators=[DataRequired()])

2. 修正图片上传存储逻辑 #

不能直接把文件对象存入数据库，需要先把文件保存到本地，再把文件路径/文件名存入数据库：
首先在app配置部分增加上传路径配置：

import os
app = Flask(__name__)
# 原有配置不变
app.config['UPLOAD_FOLDER'] = os.path.join('static', 'uploads')
# 自动创建上传目录，不存在也不会报错
os.makedirs(app.config['UPLOAD_FOLDER'], exist_ok=True)

然后修改add_book路由的保存逻辑：

@app.route('/add', methods=["GET", "POST"])
def add_book():
    form = BookForm()
    if form.validate_on_submit():
        # 先保存上传的图片文件
        img_file = form.img.data
        img_filename = img_file.filename
        img_save_path = os.path.join(app.config['UPLOAD_FOLDER'], img_filename)
        img_file.save(img_save_path)
        
        new_book = Book(
            book_name=form.book_name.data,
            book_author=form.book_author.data,
            publication_date=form.publication_date.data,
            ISBN_num=form.ISBN_num.data,
            description=form.description.data,
            # 存入文件名，后续渲染直接拼路径即可
            img=img_filename,
            price=form.price.data
         )
        db.session.add(new_book)
        db.session.commit()
        return redirect(url_for('books'))
    return render_template('add.html', form=form)

3. 其他必要操作 #

删除项目目录下旧的books.db文件，重新启动项目会自动生成新的符合字段定义的数据库文件，避免旧表结构的影响。

你的index.html里调用的图书属性名和模型定义的不匹配，需要对应修改才能正常渲染数据：
把{{book.name}}改成{{book.book_name}}，{{book.author}}改成{{book.book_author}}，{{book.date}}改成{{book.publication_date}}，{{book.num}}改成{{book.ISBN_num}}，{{book.image_file}}改成{{book.img}}即可。

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