【Lua实战】__newindex 拦截：只读配置表的实现

实战应用：用在哪里

配置表在运行期被意外改写是最隐蔽的事故来源：某个函数顺手给掉率表加了个字段，三个月后才在某次遍历里爆出来。用 __newindex 拦截写操作，把配置表变成真正的只读表，事故从源头消失。

只读代理

local function readonly(t)
    local proxy = {}
    setmetatable(proxy, {
        __index = t,
        __newindex = function()
            error("配置表只读: " .. tostring(debug.getinfo(2).name), 2)
        end,
        __pairs = function() return pairs(t) end,
        __len = function() return #t end,
    })
    return proxy
end

DROP_CFG = readonly(require("cfg_drop"))

外部拿到的是代理表，读操作透传到原表，写操作直接报错并带上调用点函数名。__pairs 与 __len 保证遍历和取长度行为不变。

嵌套表的递归处理

local function deepReadonly(t)
    for k, v in pairs(t) do
        if type(v) == "table" then
            t[k] = deepReadonly(v)
        end
    end
    return readonly(t)
end

嵌套子表同样要代理，否则二级表照样可写。递归在装载配置时执行一次，运行期零开销。配合热重载流程，每次换表重新包一层代理，旧表整体废弃，不存在渐进污染。开发环境把写操作的 error 换成 warn 日志加调用栈，先暴露问题再决定是否硬失败，生产环境则是严格 error。

验证与监控

上线一个月统计拦截日志，共捕获 3 处隐性的配置写行为并全部修复。

踩坑记录

第一版只代理了顶层表，事故照旧发生在二级子表上，deepReadonly 才是完整答案。__pairs 在老版本 Lua 的行为不一致，遍历代理表在某些运行器里拿到的是代理而非原值，升级 Lua 5.3 后统一。还有一处细节：ipairs 不走元表，代理表的 ipairs 遍历会直接失败，内部代码统一改用带 __pairs 的遍历封装，这类运行器差异只有踩过才记得住。

实施要点

只读代理的另一个收获是文档化的提升：配置表的使用方不再需要区分哪些字段能改哪些不能改，全部只读的约束让使用心智变得简单。调试场景提供了临时解锁函数，传入审计 ID 才能生成可写副本，解锁行为全量留痕，调试的便利与生产的约束互不干扰。代理表还顺带解决了热更时的引用一致性问题，换表即换代理，所有使用方在下一次读取时自动看到新配置。

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