HTTP/2服务器推送允许Nginx在客户端尚未请求关联资源时就提前下发CSS、JavaScript或图片文件，从而减少后续请求的往返时间。Nginx通过http2_push指令配置推送路径，同时内部会维护一份push diary诊断日志，用来记录每个连接上的推送队列、资源类型、推送决策以及完成状态。这份日志与常规的access.log或error.log不同，它更偏重HTTP/2协议级别的交互细节，通常需要在编译或运行时开启特定参数才能看到。一旦这条日志发生截断，运维人员往往只能看到推送动作的前半段记录，后半段关于响应码、推送失败原因、资源字节数等信息全部丢失，给故障定位带来很大困难。
理解截断问题的前提是搞清楚push diary日志的写入时机。Nginx在请求处理期间不会为每一条推送资源单独写一行日志，而是先把相关信息暂存在内存缓冲区中，等到请求结束或连接关闭时再批量刷新到磁盘。这种设计可以减少磁盘IO压力，但也意味着如果缓冲区太小、磁盘空间不足或进程接收到重载信号，正在累积的日志就可能被强制截断。此时错误日志或专门的push diary文件中会出现http2_push_diary_log_truncate这样的标记，它并不是Nginx核心模块的标准输出，而是某些定制版本或第三方补丁中用来提示日志不完整的标识。
HTTP/2 Server Push 与 push diary 日志的定位
HTTP/2 Push的核心机制是服务器在响应主文档时，通过PUSH_PROMISE帧告诉客户端后续会推送哪些资源。Nginx可以通过静态配置为某个路径指定推送资源，例如在主请求到达时同时推送/style/main.css和/js/app.js。如果使用http2_push_preload指令，Nginx还会自动读取响应头中的Link字段，把预加载提示转换成真正的推送动作。这些推送决策、目标路径以及最终是否推送成功，都需要一个结构化的记录机制来追踪，push diary日志就承担了这个角色。
在排查HTTP/2推送失败或资源重复推送的问题时，单纯查看访问日志只能看到主请求是否返回200，看不到服务器到底尝试推送了哪些资源、客户端是否接收成功。push diary日志记录的内容更接近协议层，能够帮助分析推送队列是否过长、是否存在循环推送、或者响应被过早关闭的情况。正因为这些信息量大，日志条目通常较长，一条记录包含多个键值对，有时单条长度可达数百字节。当并发连接数较高时，内存缓冲区很容易在短时间内被写满，如果Nginx没有及时把数据刷到磁盘，就会出现截断现象。
从配置角度看，push diary日志并不总是默认开启。在一些Nginx发行版或编译补丁中，需要在编译期间加入对应模块，或者通过error_log的debug级别才能看到推送决策细节。即使开启了日志，如果没有专门为push diary设置独立的缓冲策略，它也会复用通用日志模块的缓冲参数，而通用参数通常只考虑访问日志的典型长度，难以满足HTTP/2推送日志的超长条目需求。这就导致很多环境在低流量下一切正常，一旦遇到突发流量或长连接场景，截断问题就会集中爆发。
截断的典型表现与触发条件
最直观的表现是日志文件或调试输出中反复出现http2_push_diary_log_truncate标签，并且紧跟其后的日志条目明显不完整。例如一条推送记录只写到了资源路径/js/app.js就中断，缺少后续的HTTP/2流ID、推送状态码或客户端RST_STREAM帧信息。有时候截断表现为文件末尾突然出现大量空行或者半个JSON结构，这也是写入过程中被中断的典型特征。主访问日志仍然显示请求成功，但前端监控却能看到部分用户浏览器没有收到预期的推送资源，页面加载时间反而上升。
触发条件可以归纳为五个方面。第一是日志缓冲区容量不足，配置项中buffer参数设置过小，无法容纳单条完整的push diary记录。第二是磁盘空间或inode耗尽，Nginx写入时无法扩展文件，只能丢弃未写完的数据。第三是日志轮转策略不当，例如使用copytruncate方式进行轮转，会在复制文件的同时清空原文件，此时正在写入的日志很容易被截断。第四是工作进程频繁收到reload或reopen信号，旧的写入上下文被销毁，尚未刷出的日志缓冲丢失。第五是异步日志队列溢出，当磁盘IO速度跟不上日志产生速度时，队列中的日志会被直接丢弃并留下截断标记。
HTTP/2连接通常比HTTP/1.1连接存续时间更长，尤其是开启多路复用后，一个连接上可能同时处理几十个请求。如果push diary日志按照连接级别来组织，长连接累积的推送记录很可能超过预设上限，触发保护性截断。这种情况在移动端弱网环境下更为明显，因为连接断开重连频繁，日志刷新的时机也变得不可预测。要确认是否属于此类问题，可以观察截断记录是否集中在连接关闭前后，以及是否存在大量http2_push_diary_log_truncate与连接重置错误同时出现。
排查步骤：从日志偏移到配置调整
排查第一步是确认截断发生的时间点。可以在日志中搜索http2_push_diary_log_truncate标记，记录首次出现和最后出现的时间，再结合系统监控判断当时是否有磁盘IO峰值、内存使用率突增或Nginx重启操作。接着执行nginx -V查看编译参数，确认当前版本是否包含HTTP/2 Push相关的扩展模块以及日志诊断能力。如果发现该标记并不是官方Nginx输出，需要检查是否使用了第三方补丁或定制版本，因为不同版本对日志缓冲区的处理逻辑差异较大。
确认配置中日志缓冲参数的合理性是核心步骤。以下是一个简化后的Nginx配置示例，分别设置了访问日志和错误日志的缓冲参数：
http {
# 全局访问日志使用64k缓冲，每5秒刷新一次
access_log /var/log/nginx/h2_push.log combined buffer=64k flush=5s;
server {
listen 443 ssl http2;
server_name ippipp.com;
# 为根请求声明两个推送资源
http2_push /style/main.css;
http2_push /js/app.js;
}
}
在上面的配置中，buffer=64k对于普通访问日志已经足够，但如果push diary日志共用这个缓冲，单条记录可能超过64k时就会触发截断。排查时可以将缓冲区调大到256k甚至1m，并缩短flush时间，让日志更频繁地落盘。如果条件允许，可以为push diary单独指定一个文件并使用直接写入模式，虽然会牺牲一部分性能，但可以避免异步队列溢出导致的记录丢失。修改后需要执行nginx -t验证配置，然后平滑重载。
磁盘层面的检查同样不能忽略。使用df -h查看日志所在分区的剩余空间，使用df -i检查inode使用情况。如果空间或inode即将耗尽，应优先清理归档日志或迁移日志目录。对于日志轮转，建议使用create加postrotate发送USR1信号的方式，而不是copytruncate。前者会让Nginx先创建新文件再切换写入句柄，整个过程不会丢失正在写入的数据；后者在复制和清空之间有一个时间窗口，如果恰好有日志写入，就会造成截断。可以通过调整logrotate脚本模拟高并发写入场景，验证轮转过程中不会出现新的截断标记。
修复与长期监控方案
完成配置调整后，需要进行压测验证。可以使用wrk或ab模拟多个并发客户端同时访问包含大量推送资源的页面，观察压测期间日志是否完整、http2_push_diary_log_truncate是否不再出现。如果仍然偶发截断，应开启Nginx的debug日志级别，重点查看push diary缓冲区的分配与刷新过程，定位是缓冲上限设置过低还是写入函数被异常中断。生产环境开启debug日志前务必评估日志量，建议在独立的测试实例上复现问题。
为了及时发现日志截断，可以部署一个轻量级的监控脚本，每分钟扫描push diary日志并统计截断标记的出现次数。以下脚本示例会在检测到截断记录时输出告警信息，可以接入企业微信或邮件通知：
#!/bin/bash
LOG_FILE="/var/log/nginx/push_diary.log"
COUNT=$(grep -c "http2_push_diary_log_truncate" "$LOG_FILE" 2>/dev/null)
if [ "$COUNT" -gt 0 ]; then
echo "警告：检测到 $COUNT 条 HTTP/2 Push 日志截断记录"
# 在这里调用企业微信或邮件告警接口
fi
长期来看，避免日志截断需要从系统架构层面做好容量规划。HTTP/2 Push的日志量往往与推送资源数量、连接时长和并发用户数成正比，业务增长后要定期回顾日志缓冲配置是否仍然合理。同时建议将push diary日志与普通访问日志分离，使用独立的磁盘分区和轮转策略，避免互相影响。对于生产环境，还可以结合时序数据库记录每条请求的推送资源数量，一旦发现实际推送记录比预期少，就能在日志截断发生之前提前预警，从而保证HTTP/2 Push诊断信息始终完整可用。
Nginx HTTP/2 Push日志截断http2_push_diary_log_truncate修改时间：2026-08-30 07:53:54