Flask 应用：解决 SQLAlchemy 查询结果无法在网页上显示的问题-html教程-PHP中文网

Flask 应用：解决 SQLAlchemy 查询结果无法在网页上显示的问题

花韻仙語

发布： 2025-08-31 19:46:04

原创

226人浏览过

flask 应用：解决 sqlalchemy 查询结果无法在网页上显示的问题

第一段引用上面的摘要

本文旨在解决 Flask 应用中，从 MySQL 数据库查询到的数据无法在网页上正确显示的问题。通过分析 SQLAlchemy 查询结果的特性，提供将查询结果转换为 Python 字典的方法，从而使 Jinja2 模板引擎能够正确渲染数据，最终解决网页显示问题。本文提供详细的代码示例和步骤说明，帮助开发者快速定位和解决类似问题。

问题分析

在 Flask 应用中，我们经常需要从数据库中查询数据，并在网页上展示。当使用 SQLAlchemy 作为 ORM 时，查询结果通常以 Row 对象的形式返回。然而，Jinja2 模板引擎可能无法直接渲染这种类型的对象，导致网页上显示空白或出现错误。

从提供的代码可以看出，问题出现在 index.html 模板中，select 标签中的 option 元素为空。这意味着 Jinja2 无法正确读取 result1 和 result2 中的数据，导致无法生成 option 的 value 和显示内容。

解决方案：将 SQLAlchemy Row 对象转换为 Python 字典

Jinja2 模板引擎可以很好地处理 Python 字典。因此，将 SQLAlchemy Row 对象转换为 Python 字典是解决此问题的关键。

方法一：使用 dict 属性

SQLAlchemy Row 对象通常具有 __dict__ 属性，可以将其转换为字典。修改 app.py 文件中的 index 函数，如下所示：

无涯·问知

无涯·问知，是一款基于星环大模型底座，结合个人知识库、企业知识库、法律法规、财经等多种知识源的企业级垂直领域问答产品

查看详情

from flask import Flask, render_template, request
from sqlalchemy.exc import SQLAlchemyError
from sqlalchemy import create_engine

app = Flask(__name__)

@app.route("/")
def index():

    dialect = "mysql"
    username = "root"
    psw = ""
    host="localhost"
    dbname = "cyclic_championship"

    engine = create_engine(f"{dialect}://{username}:{psw}@{host}/{dbname}")

    try:
        con = engine.connect()
        query1 = "SELECT CID FROM CYCLIST"
        query2 = "SELECT SID FROM STAGE"
        result1 = con.execute(query1)
        result2 = con.execute(query2)

        # 将 result1 和 result2 转换为字典
        rows = [dict(row) for row in result1]
        rowss = [dict(row) for row in result2]

        con.close()
        return render_template("index.html", rows=rows, rowss=rowss)
    except SQLAlchemyError as e:
        error = str(e.__dict__['orig'])
        return render_template('error.html', error_message=error)

app.run(debug=False, port=5001)

登录后复制

这种方法将 result1 和 result2 转换为字典列表，然后传递给模板。

方法二：使用 mappings() 方法

SQLAlchemy 2.0 及更高版本推荐使用 mappings() 方法。它返回一个可以像字典一样访问结果的 MappingResult 对象。

from flask import Flask, render_template, request
from sqlalchemy.exc import SQLAlchemyError
from sqlalchemy import create_engine
from sqlalchemy.orm import Session

app = Flask(__name__)

@app.route("/")
def index():

    dialect = "mysql"
    username = "root"
    psw = ""
    host="localhost"
    dbname = "cyclic_championship"

    engine = create_engine(f"{dialect}://{username}:{psw}@{host}/{dbname}")

    try:
        with Session(engine) as session:
            query1 = "SELECT CID FROM CYCLIST"
            query2 = "SELECT SID FROM STAGE"
            result1 = session.execute(query1).mappings().all()
            result2 = session.execute(query2).mappings().all()
            session.close()
            return render_template("index.html", rows=result1, rowss=result2)
    except SQLAlchemyError as e:
        error = str(e.__dict__['orig'])
        return render_template('error.html', error_message=error)

app.run(debug=False, port=5001)

登录后复制

修改 HTML 模板

确保在 HTML 模板中正确访问字典中的数据。根据数据库表的结构，修改 index.html 文件如下：

<html>
<head>
<title>Hello World</title>
</head>
<body>
<h1 style="text-align:center"> Cyclist Position by stage</h1>

<form action="/">

    <table style="border:0px solid black;margin-left:auto;margin-right:auto;background-color: lightgray;width: 350px;height: 250px;">
    <tr >
        <td style="text-align:center"><label for="cyclist" >Cyclist Id:</label></td>

    </tr>
    <tr>
    <td style="text-align:center;">
        <select title="cyclist" id="cyclist" name="cyclist" style="width: 225px;">
            {% for row in rows %}
                <option value="{{ row.CID }}" style="color:#000000">{{ row.CID }}</option>
            {% endfor %}
        </select>
    </td>
    </tr>
    <tr>
    <td style="text-align:center"><label for="stage">Stage Id:</label></td>
    </tr>
    <tr>
    <td style="text-align:center">
        <select title="stage" id="stage" name="stage" style="width: 225px;color: black;">
            {% for x in rowss %}
                <option value="{{ x.SID }}" style="color: black;">{{ x.SID }}</option>
            {% endfor %}
        </select>
    </td>
    </tr>
    <tr>
    <td style="text-align:center"><input type="submit" value="Send" style="background-color:lightgreen;width: 225px;border: 1px;"></td>
    </tr>
  </form>
</table>


</body>
</html>

登录后复制

注意：将 row['cyclist'] 和 x['stage'] 分别替换为 row.CID 和 x.SID，确保与数据库表中的列名一致。

注意事项

SQLAlchemy 版本： 确保你使用的 SQLAlchemy 版本支持 mappings() 方法。如果使用较旧的版本，请使用 __dict__ 属性或自定义函数将 Row 对象转换为字典。
数据库连接： 确保数据库连接配置正确，并且数据库服务正在运行。
错误处理： 在生产环境中，应该添加更完善的错误处理机制，以便更好地诊断和解决问题。
数据安全： 在处理用户输入时，要特别注意数据安全，防止 SQL 注入等安全漏洞。

总结

通过将 SQLAlchemy Row 对象转换为 Python 字典，可以解决 Jinja2 模板引擎无法正确渲染查询结果的问题。本文提供了两种转换方法，并详细说明了如何在 Flask 应用中使用这些方法。在实际开发中，可以根据具体情况选择合适的方法，并结合错误处理和数据安全等方面的考虑，构建稳定可靠的 Web 应用。

以上就是Flask 应用：解决 SQLAlchemy 查询结果无法在网页上显示的问题的详细内容，更多请关注php中文网其它相关文章！