做嵌入 Lua 的服务端开发,大概率都经历过这种时刻:流量没涨、代码没改,监控曲线却像吹气球一样往上飘。运维在群里 @ 你,你盯着 collectgarbage("count") 打出来的数字陷入沉思——Lua 不是号称自动内存管理吗?我一行 free 都没写过,内存怎么就涨了呢?
问题恰恰出在这里:“自动”不等于”免检”。Lua 的垃圾回收更像一位按规矩办事的保洁,你随手一扔,他真不见得看得见。这篇就结合最近的版本动态和真实翻车案例,把 Lua 内存管理这件事讲透。
先把保洁的工作逻辑搞清楚:三色标记与双模式 GC
Lua 用的是经典的标记-清除(mark-and-sweep),从 5.1 开始做成了增量式:标记过程拆成小步走,跟你的程序交替执行,避免一次性 stop-the-world。到了 5.4,官方把 GC 做成了双模式——增量(incremental)和分代(generational),collectgarbage("incremental") 和 collectgarbage("generational") 可以随时切换(详见 Lua 5.4 参考手册)。
大白话讲区别:增量模式是”定期全屋大扫除,但每次只扫一部分”;分代模式是”新垃圾先收,老垃圾攒多了再大扫除”。分代基于一个经验:绝大多数对象都是短命鬼,优先扫新来的那批,效率自然高。
顺带说个新动向:2025 年 12 月 22 日发布的 Lua 5.5 进一步强化了增量回收模式,官方说明里特意提到大数组结构能省约 60% 内存,还新增了 table.create 函数——这是官方罕见地主动教你”省内存”,值得留意。
table:看起来人畜无害,其实是内存大户
Lua 的 table 本质是”数组+哈希表”的混合体。你往一个空表里塞元素,它会经历扩容、rehash 这些动作。很多服务端代码喜欢这么干:
local cache = {}
for i = 1, 100000 do
cache[i] = { id = i } -- 每个元素又是一个新 table
end
十万个元素不可怕,可怕的是每个 value 都是独立 table,GC 得挨个标记。Lua 5.5 把大数组的内存压缩到原来四成左右,算是官方亲自下场帮你省。老版本里,预分配就是最好的防御——5.5 给了 table.create(100000),5.4 及更早你可以先 local t = {} 然后一次性填满,减少 rehash 次数。
还有一个经典误区,截图里这段 Roblox 社区教程代码被无数人当反面教材引用:
关键就一句 setmetatable(Cache, {__mode = "v"})。普通 table 做缓存,key-value 永远强引用,对象死了也赖着不走;加了 __mode = "v" 变成弱表,value 不再被 table 强引用,GC 扫到就能收走。写缓存池、对象池之前,先问问自己:这个引用,我真的需要它”留着不放”吗?
字符串的坑最隐蔽:interning 让你删都删不掉
这是 Lua 内存问题里最容易翻车的一条。Lua 的短字符串走 interning(驻留) 机制:内容相同的字符串在 VM 里只有一份。好处是比较极快,代价是——字符串一旦创建,永不重复创建,而你是否”引用”它,决定了它能不能被回收。
翻一个真实案例:网络流量分析工具 Arkime 的 Lua 插件 issue #3295 报告了内存泄漏,根因正是会话对象 session:table() 在回调里反复创建关联数据,会话生命周期内无人释放。这类”藏在 C 边界后面”的引用,Lua 的 GC 根本看不见全貌。
再典型不过的自杀式写法:
local s = ""
for i = 1, 1e6 do
s = s .. "x" -- 每次拼接产生新字符串,旧的等待 GC
end
百万次拼接产生百万个中间字符串。Lua 5.4 对字符串拼接做了优化(.. 有专用 OP_CONCAT 指令,并做了缓冲复用),但你把结果再拼进循环,照样会把驻留表撑大。正确姿势:先攒进 table,最后 table.concat(t) 一次搞定。
用弱表做字符串缓存同样有效,思路跟上面 table 那段一模一样。
别只会 collectgarbage(“collect”):参数与验证手段
collectgarbage 这个函数,90% 的人只会用两个参数:"collect" 和 "count"。其实它是一整套控制台。
增量模式三个旋钮(默认值来自官方手册):
collectgarbage("incremental", 200, 100, 13)
-- pause=200 内存翻倍才开启新一轮回收
-- stepmul=100 回收速度=分配速度
-- stepsize=13 每分配约 8KB 走一步
分代模式两个旋钮:collectgarbage("generational", 20, 100),minor 阈值 20(内存涨 20% 就小收一次),major 阈值 100(翻倍才大扫除)。
Jabber/XMPP 服务器 Prosody 的官方文档 里有个很务实的经验值:长期运行的服务端,增量模式 pause=105、speed=250——也就是内存涨 5% 就触发回收、回收速度是分配速度的 2.5 倍。代价是 CPU 更忙,换来的常驻内存低得多。pace(节奏)的本质就是拿 CPU 换内存,或者反过来,没有银弹,看你的约束是哪头。
有一点必须泼冷水:Prosody 文档反复强调,GC 参数不可移植,换个 Lua 版本行为可能完全不同。你在 5.4 上调好的参数,升 5.5 后务必重新压测。
最后附上我自己排查内存涨速的验证脚本,任何环境下都能跑:
local function snapshot(tag)
collectgarbage("collect")
collectgarbage("collect") -- 两轮确保回收干净
print(tag, string.format("%.1f KB", collectgarbage("count")))
end
snapshot("start")
-- ... 执行业务逻辑 ...
snapshot("after")
前后差值就是你的真实驻留增量。如果想看对象级别的分布,Roblox 生态有现成的内存面板可以直接看每个模块占多少:
另一个容易忽略的点是宿主边界:Lua 是被 C/C++ 嵌入的,C 侧持有的引用(registry、userdata 的 uservalue)GC 管不全。架构上长这样,内存责任的边界也就清楚了:
写在最后
Lua 内存管理的核心就一句话:GC 只负责回收”它确认死了”的东西,而你代码里那些”看起来死了、其实还被谁攥着”的对象,它一个都不会动。table 别乱缓存、字符串别瞎拼、缓存上弱表、参数按场景调、前后对照验证——做到这五条,凌晨三点的告警基本跟你无缘了。
你的项目里踩过最离谱的 Lua 内存坑是哪个?评论区聊聊,说不定你掉的坑,别人也刚爬出来。
(参考资料:Lua 5.4 参考手册 · Lua 5.5 发布说明 · Prosody 高级 GC 配置 · Roblox 开发者论坛 GC 教程 · Arkime Lua 内存泄漏 issue)
