【网络通信】LuaSendMsg：变参协议的发送封装

实战应用：用在哪里

LuaSendMsg 是前端网络发送的统一封装：变参的设计让不同协议的参数个数灵活可变，统一走 global.networkCtl:SendMsg(...) 的出口。变参的协议封装是前端网络层的核心模式，所有消息的发送都走这一个出口。

变参的发送

---变参消息发送（整理自 networkUtil.lua）
function LuaSendMsg(...)
    global.networkCtl:SendMsg(...)
    -- 调试统计
    if _DEBUG and _LOG_SEND_ABLE then
        local data = {...}
        local msgID = data[1]
        _LOG_SEND_NET_MSG[msgID] = _LOG_SEND_NET_MSG[msgID] or { hits = 0 }
        _LOG_SEND_NET_MSG[msgID].hits = _LOG_SEND_NET_MSG[msgID].hits + 1
        _LOG_SEND_NET_MSG[msgID].msgId = msgID
    end
end

变参 ... 让不同协议的参数个数灵活：三参数的移动协议与七参数的战斗协议都走同一个 LuaSendMsg。调试统计按消息号计数命中次数，高频的消息号是性能优化的优先目标。发送的统一出口让日志与限流有一个天然的切入点。

消息号与载荷

---SendTableToServer：表结构的 JSON 上送
function SendTableToServer(msgID, tableData)
    local jsonStr = cjson.encode(tableData)
    if not jsonStr then
        print(msgID, "json data encode error")
        return nil
    end
    LuaSendMsg(msgID, 0, 0, 0, 0, jsonStr)
end

SendTableToServer 把表结构编码成 JSON 后按变参通道发送，业务层传表不用关心编码细节。编码失败的保护：cjson.encode 返回空时打日志并返回 nil，坏数据不出门。消息号的调试统计与发送的计数共用开关，生产环境的开销趋近于零。

验证与监控

消息的发送频次按 msgID 统计，高频消息号是性能优化的优先目标。

踩坑记录

变参的长度曾经没有校验，多余的参数被静默丢弃导致服务端解析错位，参数个数的断言在发送前完成。cjson 的编码不支持 Lua 的循环引用表，带循环引用的表编码时无限递归，表的预检过滤循环引用。

上线要点

LuaSendMsg 的统一出口让日志与限流有一个天然的切入点，绕过封装直调引擎发送在代码评审里不允许。消息号与参数个数的协议文档进团队的知识库，协议的变更有据可查。调试统计的开关按环境区分：开发全开、生产关闭，开关的配置随包分发。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。