Flask模板流式渲染在Debian12失效，本地Mac环境正常

核心问题：Nginx与Gunicorn的响应缓冲阻塞了流式输出 #

本地开发用的Flask内置服务器默认支持无缓冲的流式输出，但部署到Debian后，Nginx和Gunicorn的默认配置会缓冲响应内容，直到缓冲区填满或响应结束才发送给浏览器，直接导致流式渲染失效。

1. 调整Nginx配置（关键修复） #

Nginx默认会缓冲代理后端的响应，需在location /块中添加禁用缓冲的配置：

location / {
    include proxy_params;
    proxy_pass http://unix:/home/username/projectdir/projectname.sock;
    # 禁用代理缓冲，实时转发响应
    proxy_buffering off;
    proxy_cache off;
    # 强制启用分块传输编码
    proxy_set_header Transfer-Encoding chunked;
}

修改后重启Nginx：sudo systemctl restart nginx

2. 优化Gunicorn配置 #

Gunicorn的默认sync worker虽支持流式，但需确保无额外缓冲。修改service文件的ExecStart行：

ExecStart=/home/username/projectdir/env/bin/gunicorn --workers 3 --bind unix:projectname.sock -m 007 --sendfile off wsgi:app

若仍有问题，可改用gevent worker（需先安装pip install gevent）：

ExecStart=/home/username/projectdir/env/bin/gunicorn --workers 3 --bind unix:projectname.sock -m 007 --worker-class gevent wsgi:app

修改后重启Gunicorn服务：sudo systemctl restart projectname

3. 补充Flask响应头部 #

在返回Response时，明确设置禁用缓存和分块传输的头部，避免浏览器缓冲内容：

from flask import Response, stream_with_context

@app.post('/some_endpoint')
def endpoint():
    @stream_with_context
    def stromen():
        i = 0
        for i in range(100):
            yield f"{i:03}"
            time.sleep(0.5)
    
    return Response(
        stream_with_context(
            stream_template(
                "templatename.html",
                stuff=stromen()
            )
        ),
        headers={
            'Transfer-Encoding': 'chunked',
            'Cache-Control': 'no-cache, no-store, must-revalidate',
            'Pragma': 'no-cache',
            'Expires': '0'
        }
    )

4. 禁用Jinja2模板缓冲 #

Jinja2默认会缓冲渲染输出，需在Flask配置中关闭：

app.config['JINJA2_BUFFER_SIZE'] = 0

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