Flask无法返回指定目录下文件的渲染结果，该如何排查？

核心错误点 #

你代码中误用了send_from_directory方法：
该方法的作用是直接将目标文件作为HTTP响应返回（等价于让用户直接访问原始文件/下载文件），返回值是Flask响应对象，并非你需要的文本文件内容。你将该响应对象传入模板，自然无法渲染出预期的文件内容。

修复代码示例 #

from flask import Flask, request, render_template, abort
import os

# 实例化Flask应用
app = Flask(__name__)
app.config.from_object(__name__)
# 定义Special_Data目录的绝对路径，避免相对路径定位错误
SPECIAL_DATA_DIR = os.path.join(app.root_path, 'Special_Data')

@app.route("/")
@app.route("/index")
def index():
    return render_template('index.html')

@app.route("/Special_Data/<path:path>")
def page(path):
    # 拼接目标文件完整路径
    target_file = os.path.join(SPECIAL_DATA_DIR, path)
    # 路径安全校验：防止恶意用户通过路径遍历读取服务器敏感文件
    if not os.path.commonprefix([target_file, SPECIAL_DATA_DIR]) == SPECIAL_DATA_DIR:
        abort(403)
    # 校验文件存在且为普通文本文件
    if not os.path.isfile(target_file):
        abort(404)
    # 读取文件内容，编码可根据你的实际文件编码调整
    try:
        with open(target_file, 'r', encoding='utf-8') as f:
            file_content = f.read()
    except UnicodeDecodeError:
        abort(400, description="目标文件不是可读取的文本格式")
    # 将读取到的文本内容传入模板渲染
    return render_template('page_template.htm', page=file_content)

模板适配提示 #

如果需要保留文本文件的换行、空格等原始格式，可以在page_template.htm中用<pre>标签包裹渲染变量，或者给渲染容器添加white-space: pre-wrap CSS属性。默认情况下Jinja2会自动转义内容中的HTML标签避免XSS风险，如果你的文本内容中包含需要生效的HTML代码，可以使用{{ page|safe }}语法渲染。

额外说明 #

你原有代码中初始化的FlatPages实例未被使用，如果你的Special_Data目录下存储的是Markdown格式文件，可以直接调用FlatPages提供的API获取解析后的内容，无需自行读取文件。

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