lua-resty-http模块中body_reader的正确使用方式

在使用OpenResty的lua-resty-http模块时，开发者经常会遇到需要流式处理HTTP响应体的场景。本文将通过一个典型错误案例，深入分析如何正确使用body_reader功能。

问题现象

开发者在尝试使用lua-resty-http模块的body_reader功能时，遇到了"can't resume a dead coroutine"的错误。错误发生在以下场景：

1. 使用request_uri方法发起HTTP请求
2. 尝试通过res.body_reader以流式方式读取响应体
3. 在循环读取缓冲区时抛出协程已死的异常

根本原因分析

这个问题源于request_uri和request方法的关键区别：

1. request_uri是一个简化版的请求方法，它会自动处理所有响应数据，包括完整读取响应体
2. 当使用request_uri时，响应体已经被完整读取并存储在res.body中
3. 此时再尝试使用body_reader进行流式读取，实际上是在操作一个已经关闭的协程

正确解决方案

要使用body_reader进行流式处理，必须使用request方法而非request_uri方法。request方法提供了更底层的控制，允许开发者手动处理响应流程。

以下是正确的实现方式：

local http = require "resty.http"
local http_client = http.new()
http_client:set_timeouts(1000 * 60, 1000 * 60, 1000 * 60)

-- 使用request方法而非request_uri
local res, err = http_client:request({
    method = "GET",
    path = "/",
    headers = {
        ["Host"] = "example.com"
    }
})

if not res then
    ngx.log(ngx.ERR, "request failed: ", err)
    return
end

-- 现在可以安全使用body_reader
local reader = res.body_reader
local buffer_size = 1024

repeat
    local buffer, err = reader(buffer_size)
    if err then
        ngx.log(ngx.ERR, err)
        break
    end

    if buffer then
        ngx.say(buffer)
        ngx.flush(true)
    end
until not buffer

性能考量

使用body_reader进行流式处理相比一次性读取整个响应体有以下优势：

1. 内存效率更高，特别适合处理大文件
2. 可以实现边下载边处理的实时效果
3. 减少客户端等待时间，提高用户体验

最佳实践建议

1. 对于小响应体，可以直接使用request_uri和res.body
2. 对于大文件或需要流式处理的场景，使用request配合body_reader
3. 合理设置buffer_size，平衡内存使用和IO效率
4. 注意错误处理和资源释放

通过理解lua-resty-http模块的内部工作机制，开发者可以更有效地处理各种HTTP请求场景，避免常见的陷阱和错误。