Apache部署的Linux服务器中Python脚本内容刷新失效求助

问题核心 #

你遇到的问题根源不在于Python的缓冲设置，而是Apache Web服务器默认会缓冲CGI/FastCGI脚本的输出，直到脚本执行完毕才一次性返回给浏览器。即便你在Python里关闭了输出缓冲，Apache的上层缓冲依然会拦截内容，导致无法实时刷新。

解决步骤 #

1. 修改Apache配置禁用输出缓冲 #

根据你使用的Apache模块（mod_cgi或mod_fcgid），在对应的脚本目录配置中添加以下规则：

针对mod_cgi的配置

编辑Apache的配置文件（如httpd.conf或虚拟主机配置文件），找到你的CGI脚本所在目录的<Directory>块，添加：

<Directory /path/to/your/cgi-scripts>
    Options +ExecCGI
    SetHandler cgi-script
    # 禁用gzip压缩，避免缓冲
    SetEnv no-gzip 1
    # 告诉浏览器不要缓存内容
    Header set Cache-Control "no-cache, must-revalidate"
    # 强制Apache每次输出后立即刷新
    FlushOnEveryEvent On
</Directory>

针对mod_fcgid的配置

如果使用FastCGI，替换为以下配置：

<Directory /path/to/your/cgi-scripts>
    Options +ExecCGI
    SetHandler fcgid-script
    SetEnv no-gzip 1
    Header set Cache-Control "no-cache, must-revalidate"
    # 禁用FastCGI输出缓冲
    FcgidOutputBufferSize 0
</Directory>

修改完成后，重启Apache生效：

sudo systemctl restart apache2

2. 调整Python脚本的CGI头部与输出逻辑 #

确保脚本开头的CGI头部正确，且必须用空行分隔头部和内容，同时保留flush操作：

#!/usr/bin/env python3
import sys
import time

# 发送标准CGI响应头部
print("Content-Type: text/html; charset=utf-8")
print()  # 必须的空行，分隔头部和正文

for i in range(5):
    # 输出HTML格式内容，确保浏览器能解析换行
    print(f"实时输出: {i+1}<br>")
    # 强制刷新输出流
    sys.stdout.flush()
    # 模拟耗时操作
    time.sleep(1)

3. 浏览器端验证 #

• 按Ctrl+F5强制刷新页面，避免浏览器缓存旧内容
• 确保浏览器未开启"离线模式"或强制缓存功能

验证逻辑 #

完成上述配置后，访问脚本URL，应该能看到页面每隔1秒新增一行内容，而非等待5秒后一次性显示所有输出。

内容的提问来源于stack exchange，提问作者Urri From URSystems