Nginx的ngx_http_top_body_filter是否总会触发0长度最终分块？

API 探路者

2026-6-16

Nginx分块传输编码（Chunked Transfer Encoding）的最终0长度分块处理逻辑

Nginx的分块传输编码逻辑默认会自动生成并发送最终的0长度分块，开发Nginx模块（或附件）时无需在代码中显式处理这部分逻辑。

Nginx的Chunked编码处理链路
当响应启用分块传输编码（即响应头包含Transfer-Encoding: chunked且未设置Content-Length），Nginx的ngx_http_chunked_filter_module会接管响应体的编码工作。ngx_http_top_body_filter作为body filter链的入口，会将响应体数据逐层传递到chunked filter，由它负责将数据拆分为符合规范的分块，并在所有响应体数据发送完成后，自动添加最后的0长度分块（格式为0\r\n\r\n）。
模块开发时的注意事项
开发Nginx模块时，你只需要正常通过body filter链输出响应体数据即可——比如调用ngx_http_output_filter传递数据缓冲区，或者在自定义filter中处理后向下游filter传递。当所有数据输出完成，调用ngx_http_finalize_request结束请求，Nginx的chunked filter会自动完成最终分块的发送，不需要你手动构造任何chunk格式的内容。
与Envoy实现的差异
Nginx的实现严格遵循HTTP规范（RFC 7230），因此无论场景如何，只要启用了chunked编码，就会发送最终的0长度分块。而Envoy的特殊行为属于其自身的实现选择，和Nginx的设计逻辑无关。
验证方式
可以通过抓包工具（如tcpdump、Wireshark）捕获Nginx的响应报文，或者开启Nginx的debug日志（配置error_log ... debug;），查看最终的响应尾段是否包含0\r\n\r\n的结束标记。