行会仓库扣物接口出了资金纠纷，追查时发现该函数没有任何调用日志——谁在什么时候扣了谁的货无从谈起。给每个函数手动加日志要改所有函数体，漏改是常态。装饰器封装：把原函数包一层，调用前后自动留痕，业务函数零改动，关键链路的审计日志一次接入。
通用装饰器与业务接线：包装函数保留原签名，前后打点。示例代码如下：
local function traced(fn, name)
return function(actor, ...)
local t0 = os.clock()
sendmsg(nil, 1, "[审计] " .. name .. " 入参=" .. tostring(actor))
local a, b, c = fn(actor, ...)
local cost = (os.clock() - t0) * 1000
sendmsg(nil, 1, "[审计] " .. name .. " 耗时=" ..
string.format("%.2f", cost) .. "ms")
return a, b, c
end
end
local function takeGoods(actor, itemId, num)
actor = getplayerbyname(actor)
local ok = takeitem(actor, itemId, num, 0, "行会仓库扣物")
sendmsg(actor, 1, "扣取 " .. itemId .. " 乘 " .. num)
return ok
end
takeGoods = traced(takeGoods, "warehouse_take")
装饰后的调用对业务调用方无感知：示例代码如下：
takeGoods("无名小卒", "黑铁矿石", 30)
调用前留入参审计行，调用后留耗时行，原函数一字未改。
traced 返回的新函数与原函数签名一致（actor 加可变参数），上层调用无感知；多返回值用 a, b, c 中转透传，覆盖绝大多数两三个返回值的业务函数。os.clock 计时到毫秒级，耗时超过 5 毫秒的调用可在审计行追加标记。装饰只改"引用"，原函数本体仍是可测试的纯函数——审计与业务解耦。
装饰器踩过三个坑：一是可变参数透传时只接了两个固定参数，某次调用传了第三个参数被静默丢弃，包装函数一律用 ... 加 select 接全量参数再原样转发；二是审计日志本身走 sendmsg，被装饰的函数又高频调用审计日志，形成日志放大，高峰期单接口每秒产生 3000 条审计行把频道刷爆——审计输出改写入内存环形缓冲、定时批量落盘；三是装饰后的函数丢失原名字（匿名闭包），报错堆栈里全是问号，包装时把 name 写进函数名注释并在错误信息里自带函数标识。
全站技术干货持续更新：996 引擎 / Lua 实战帖，语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →
一、抛坑提问：三方增强插件直接 getmetatable(weapon) 拿到元表，把裁决之杖攻击改到 9999。元表能不能…
一、一行代码拆解：rawget(PriceList, name) —— 这一行绕过元表直达表本体，价目查询不走 __inde…
一、隐蔽陷阱：沙巴克守城名单清理离线成员，正序 for 循环里 table.remove(list, i)，删一个后续整体前…
一、线上事故：运营要按供需公式浮动裁决之杖价格，某次把表达式字符串直接塞进裸 loadstring 执行，串里夹带未知全局调…
一、线上事故：红名洗白进度按 10 段槽位刷新，GM 修正过 PK 值的玩家带着 -8 的负值进来，进度槽算出 -2，进度条…
一、抛坑提问：烈火剑法连招表存着 4 段延时 {200, 400, 600, 900}，算总窗要逐个相加。段数扩到 6 段，…