Nginx代理场景下无法完整展示Flask模板渲染内容

直连Gunicorn端口访问时页面完全正常，说明Flask路由逻辑、CSV数据读取、Jinja2模板渲染链路没有任何问题，故障完全出在Nginx反向代理层。结合「短字段（标题、发布日期）正常展示、长正文丢失」的典型特征，故障原因按出现概率从高到低排序：

• 代理缓冲+临时目录权限问题（占这类故障的90%以上）：Nginx反向代理默认会开启响应缓冲，长度小于内存缓冲区阈值的响应会直接放在内存里返回给客户端，长度超出阈值的响应会被拆分写入代理临时目录落盘存储。如果Nginx worker进程的运行用户对代理临时目录没有读写权限，超出缓冲区的正文内容就会被丢弃，只有能放进内存的短字段能正常返回。
• 内容过滤规则误截断：如果Nginx配置中写了sub_filter内容替换、add_before_body/add_after_body内容插入规则，正则匹配逻辑写得有缺陷时，可能误匹配正文中的HTML标签（因为正文用了|safe过滤器渲染原生HTML），把正文部分内容替换为空或者直接截断。
• 响应头处理错误：如果Nginx配置中错误修改了Content-Length响应头，或者和后端的gzip压缩逻辑冲突（比如后端返回gzip压缩后的响应，Nginx没有正确识别压缩格式就按明文计算长度），会导致浏览器收到的响应体实际长度和头中标注的长度不匹配，长内容会被浏览器直接截断不渲染。
• 安全规则误拦截：如果Nginx配置了XSS强拦截规则，或者接入了WAF，包含原生HTML标签的长正文可能被判定为恶意注入内容，被直接拦截丢弃。

• 优先排查缓冲与权限问题
  1. 先在对应反向代理的location配置块中加入proxy_buffering off;，执行nginx -s reload重载配置后测试，如果正文正常显示，即可确认是缓冲相关问题。
  2. 执行ps aux | grep nginx查看Nginx worker进程的运行用户（通常为nginx或www-data），再执行nginx -V找到编译参数中--http-proxy-temp-path对应的代理临时目录路径，执行chown -R 运行用户:用户组 临时目录路径修复目录权限。
  3. 不需要关闭代理缓冲的场景，可以适当调大缓冲参数，在代理配置块中加入如下配置后重载即可：

  proxy_buffer_size 32k;
  proxy_buffers 8 16k;
  proxy_busy_buffers_size 64k;
  

• 排查内容过滤规则
  临时注释掉Nginx配置中所有sub_filter、内容插入相关的规则，重载配置测试，如果页面恢复正常，逐行调试过滤规则的正则逻辑，避免误匹配正文内的HTML标签。
• 排查响应头与压缩配置
  1. 分别用curl直连Gunicorn端口、走Nginx代理访问同一条博文，对比两个响应的Content-Length、Content-Encoding字段值，如果Nginx返回的Content-Length明显小于直连值，说明响应头被错误修改。
  2. 如果后端Gunicorn开启了gzip压缩，可以在Nginx代理配置中加proxy_set_header Accept-Encoding "";，让后端返回明文响应给Nginx处理，避免压缩/解压逻辑不匹配导致的长度计算错误。
• 排查安全拦截规则
  临时关闭WAF规则、以及配置中添加的X-XSS-Protection: 1; mode=block这类强拦截头，测试正文是否正常返回，如果是规则误判，将博客路径加入安全规则白名单即可。

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