Flask 中 render_template 不生效的常见原因及解决方案-Python教程-PHP中文网

Flask 中 render_template 不生效的常见原因及解决方案

Flask 路由函数必须显式返回响应对象（如 render_template() 的结果），若遗漏 return 语句，视图函数将默认返回 None，导致页面空白且无报错。

flask 路由函数必须显式返回响应对象（如 `render_template()` 的结果），若遗漏 `return` 语句，视图函数将默认返回 `none`，导致页面空白且无报错。

在 Flask 开发中，一个极易被忽视却高频出现的问题是：调用 render_template() 后未使用 return 关键字返回其结果。这会导致路由函数静默执行完毕但不向客户端发送任何 HTML 内容——浏览器显示空白页，控制台也无错误提示，极易误判为模板路径、配置或 Jinja2 语法问题。

✅ 正确写法（关键：必须 return）

from flask import Flask, render_template

app = Flask(__name__, template_folder='templates')  # 注意路径相对当前运行文件

@app.route('/')
def index():
    return render_template('renderindex.html', username="Alice", userid="12345")

⚠️ 错误示例（无 return，即使命中路由也无响应）：
@app.route('/')
def index():
    render_template('renderindex.html', username="Alice", userid="12345")  # ❌ 静默失效

? 其他常见排查点（配合 return 一并检查）

模板路径是否正确？
template_folder 参数应为相对于 app.py 所在目录的相对路径。例如项目结构为：

Auth0 Flask
在Flask应用中使用基于会话的身份验证实现登录、登出和用户资料，集成auth0-server-python进行服务端渲染

下载
```
/project
  ├── app.py          ← 运行此文件
  └── templates/
        └── renderindex.html
```
则应设为 template_folder='templates'（非 '../templates'）。若 app.py 在子目录中，需按实际层级调整。
模板文件名拼写与扩展名是否匹配？
确保 render_template('renderindex.html') 中的文件名与 templates/ 下真实文件名完全一致（含大小写、.html 后缀）。
避免重复定义同一路由
在你提供的完整代码片段中，@app.route('/') 被定义了两次（index 和 display_results），后者会覆盖前者。Flask 不允许同一路径绑定多个视图函数，后注册者生效，且 display_results(query_results) 的参数 query_results 并非由 Flask 传入（它没有 request 或 URL 参数），会导致 TypeError。应改为：
```
@app.route('/')
def index():
    # 可在此处准备数据，或重定向到带参数的路由
    return render_template('results.html', data={})  # 占位或动态加载

@app.route('/results')
def display_results():
    query_results = make_api_requests("P50012960")  # 示例逻辑
    return render_template('results.html', data=json.loads(query_results))
```