1. 为什么需要这个组合？

想象你正在搭建一个高并发的API网关，每秒要处理上万个请求。这时候直接访问数据库会像在早高峰挤地铁一样痛苦，而Redis就像专用快速通道，能帮你缓存热点数据。OpenResty的Lua脚本能力，则像给这个快速通道装上了智能导航系统，但如何确保导航系统不会突然死机？这就是我们今天要解决的难题。

2. 环境准备（基于OpenResty 1.21+）

在开始飙车之前，先确认你的工具箱：

# 安装OpenResty
wget https://openresty.org/package/centos/openresty.repo
sudo mv openresty.repo /etc/yum.repos.d/
sudo yum install -y openresty

# 安装Redis（以Docker为例）
docker run -d --name my-redis -p 6379:6379 redis:6-alpine

3. 基础集成示例

先看个标准姿势，就像系好安全带再开车：

location /cache {
    content_by_lua_block {
        local redis = require "resty.redis"
        local red = redis:new()
        
        -- 设置超时（单位：毫秒）
        red:set_timeouts(1000, 1000, 1000)  -- 连接/发送/接收超时
        
        -- 连接Redis
        local ok, err = red:connect("127.0.0.1", 6379)
        if not ok then
            ngx.log(ngx.ERR, "连接失败: ", err)
            return ngx.exit(500)
        end
        
        -- 执行命令
        local res, err = red:get("my_cache_key")
        if not res then
            ngx.log(ngx.ERR, "查询失败: ", err)
        end
        
        -- 释放连接（重要！）
        red:close()
        ngx.say(res or "未找到数据")
    }
}

这个示例就像汽车的基本操作手册，但现实中你会遇到各种突发状况。

4. 异常处理三重奏

4.1 连接失败时的备胎方案

local ok, err = red:connect("127.0.0.1", 6379)
if not ok then
    ngx.log(ngx.WARN, "主库连接失败，尝试备用: ", err)
    ok, err = red:connect("backup.redis.host", 6380)
    if not ok then
        ngx.log(ngx.ERR, "备用库也挂了！")
        return ngx.exit(503)
    end
end

4.2 超时重试机制

local retries = 3  -- 最多重试3次
for i = 1, retries do
    local res, err = red:get("hot_data")
    if res then break end
    
    if err == "timeout" then
        ngx.log(ngx.WARN, "第"..i.."次超时，重试中...")
        if i == retries then
            return nil, "最终尝试失败"
        end
    else
        break  -- 非超时错误直接退出
    end
end

4.3 连接池管理

-- 初始化阶段配置连接池
local pool_size = 100  -- 根据业务需求调整
red:set_keepalive(60000, pool_size)  -- 空闲1分钟，最大100连接

-- 业务使用模板
local function with_redis(callback)
    local red = redis:new()
    -- ...连接逻辑...
    
    -- 使用protected call捕获异常
    local ok, res = pcall(callback, red)
    if not ok then
        ngx.log(ngx.ERR, "Redis操作异常: ", res)
        red:close()  -- 异常时直接关闭
        return nil
    end
    
    red:set_keepalive()  -- 正常归还连接池
    return res
end

5. 典型应用场景

5.1 限流器实现

local limiter_key = "rate_limit:"..ngx.var.remote_addr
local current = red:incr(limiter_key)
if current == 1 then
    red:expire(limiter_key, 60)  -- 首次设置过期时间
end

if current > 100 then
    ngx.exit(429)  -- 超过100次/分钟
end

5.2 分布式会话存储

local session_id = ngx.var.cookie_SESSIONID
if session_id then
    local user_data = red:get("session:"..session_id)
    if user_data then
        -- 自动续期
        red:expire("session:"..session_id, 1800)
        return user_data
    end
end

6. 技术优劣势分析

优势组合拳：

  • 响应速度：LuaJIT+Redis的组合，处理速度堪比F1赛车
  • 资源利用：连接池复用像共享单车经济
  • 灵活性：Lua脚本可以编写复杂逻辑，像瑞士军刀

需要警惕的坑：

  • 内存泄漏：未正确关闭的连接就像忘记关的水龙头
  • 雪崩效应：批量缓存失效时，数据库可能被压垮
  • 集群切换：主从故障转移时的短暂不可用期

7. 必须牢记的注意事项

  1. 超时设置黄金法则：总超时 < Nginx请求超时，建议设置梯度超时（如连接500ms，操作300ms）
  2. 连接生命周期管理：就像用完工具要放回原位，确保每个连接都正确归还
  3. 异常日志分级：区分网络错误（ERROR级）和业务空数据（INFO级）
  4. 压力测试必备：使用wrk或jmeter模拟突发流量，观察连接池表现
  5. 版本兼容性：确认使用的lua-resty-redis版本支持Redis的新命令

8. 总结

通过本文的探索，我们像组装乐高一样搭建了OpenResty与Redis的稳定桥梁。记住几个关键数字：3次重试、100连接池、1000ms超时，这些参数就像烹饪食谱中的关键配料，需要根据你的业务烤箱温度调整。当遇到连接异常时，把它想象成高速公路上的突发状况——提前准备备用路线（备用节点）、配备应急工具（重试机制）、训练专业司机（连接池管理），才能确保你的数据快车永远畅通无阻。

下次当你的OpenResty服务需要与Redis共舞时，带上这些技巧，让高并发场景下的数据处理变得像跳华尔兹一样优雅从容。记住，好的异常处理不是让系统永远不失败，而是失败时能优雅地恢复，就像优秀的舞者即使踩到脚也能继续旋转。