Flask表单提交遇405错误及SQLite数据插入失败问题排查

1. 错误原因 #

「405 Method not allowed」错误原因 #

• 表单提交使用的HTTP方法（通常是POST）与后端路由支持的方法不匹配：比如后端路由默认仅开启GET方法，但表单用POST提交请求
• 表单的action属性路径写错，指向了未配置对应请求方法的路由
• 部分Web框架的路由默认只支持GET，未显式声明支持POST

SQLite插入失败原因 #

核心是请求被405错误拦截，根本没执行到数据库插入的代码逻辑；如果请求能到达后端，还可能是：

• 数据库连接未正确初始化或关闭
• SQL插入语句的字段与表结构不匹配（比如字段名拼写错误、字段数量不一致）
• 未手动提交SQLite事务（SQLite默认需要调用commit()才能保存数据）

2. 修复方案 #

修复405错误 #

方案1：更新后端路由，支持对应请求方法

以Flask框架为例，修改app.py中的路由，显式声明支持GET和POST方法：

from flask import Flask, request, render_template

app = Flask(__name__)

# 显式添加methods参数，支持GET和POST
@app.route('/submit', methods=['GET', 'POST'])
def submit_form():
    if request.method == 'POST':
        # 这里写表单处理和数据库插入逻辑
        pass
    return render_template('bootstrap_table.html')

方案2：修正前端表单的method和action属性

检查bootstrap_table.html中的表单代码，确保请求方法和目标路由正确：

<!-- 确保action路径与后端路由一致，method与后端支持的方法匹配 -->
<form action="/submit" method="POST">
    <!-- 表单输入字段 -->
    <input type="text" name="username">
    <button type="submit">Submit</button>
</form>

• 确认action的路径和后端路由的路径完全一致（注意斜杠、拼写错误）
• 确认method的值（POST或GET）和后端路由methods参数中的值匹配

修复SQLite插入失败（解决405后） #

确保数据库操作逻辑正确，示例代码如下：

import sqlite3

@app.route('/submit', methods=['GET', 'POST'])
def submit_form():
    if request.method == 'POST':
        # 获取表单数据
        username = request.form.get('username')
        age = request.form.get('age', type=int)
        
        # 连接SQLite数据库
        conn = sqlite3.connect('mydb.db')
        cursor = conn.cursor()
        
        try:
            # 使用参数化查询避免SQL注入，同时确保字段与表结构匹配
            cursor.execute("INSERT INTO users (username, age) VALUES (?, ?)", (username, age))
            conn.commit()  # 必须提交事务才能保存数据
        except Exception as e:
            conn.rollback()  # 出错时回滚事务
            print(f"插入失败：{str(e)}")
        finally:
            conn.close()  # 关闭数据库连接
    return render_template('bootstrap_table.html')

额外检查项：

• 确认SQLite数据库文件存在，表结构与插入语句的字段一致
• 若表单字段可能为空，需在代码中做校验，或设置数据库表字段允许空值

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