CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
高级技巧996引擎协程超时安全resume

【高级技巧】协程超时兜底:resume与pcall的组合封装

2026-09-26 03:53 作者:996 技术组 996引擎Lua教程传奇脚本高级技巧996引擎Lua协程超时安全resume

底层原理

协程体内出错时 resume 返回 ok=false 与错误对象,但协程体若死循环则 resume 永久挂起——错误能兜、死循环兜不住。超时兜底的思路:每次 resume 前记录时间戳,协程体内每完成一个批次主动 yield 汇报进度,调度侧检查“距上次 yield 是否超时”,超时即判定协程僵死并放弃恢复。

高级封装

带进度汇报的协程。示例代码如下:

lua
local function makeWorker(items, batch)
    local co = coroutine.create(function()
        local done = 0
        for _, item in ipairs(items) do
            processItem(item)
            done = done + 1
            if done % batch == 0 then
                coroutine.yield(false, done)
            end
        end
        coroutine.yield(true, done)
    end)
    return co
end

超时调度。示例代码如下:

lua
local function runWithWatch(co, timeoutSec)
    while true do
        local start = os.time()
        local ok, finished, done = coroutine.resume(co)
        if not ok then
            print("协程出错:" .. tostring(finished))
            return false
        end
        if finished then
            print("完成,共 " .. done .. " 条")
            return true
        end
        if os.time() - start > timeoutSec then
            print("单批超时,协程僵死")
            return false
        end
    end
end

接口拆解

makeWorker 的协程每处理 batch 条就 yield(false, done) 让出执行权并汇报进度,全部完成后 yield(true, done) 报完成;runWithWatch 循环 resume——resume 内部错误由 ok=false 捕获,单批耗时超过 timeoutSec 判定僵死放弃。yield 的双返回值分工:第一参数是完成标志、第二参数是进度计数。

踩坑记录

协程超时兜底踩过三个坑:一是 resume 的 pcall 语义被误解,协程体内 error 会由 resume 以 ok=false 返回而非抛出,调用方漏判 ok 导致错误静默;二是批内单条处理本身死循环依然挂起——批粒度必须足够小,单条不可控时无法兜底;三是超时放弃后协程状态遗留,复用前必须重新 create,旧的挂起协程不再 resume。

踩坑记录补

补充一条高频踩坑:yield 的返回值只在下次 resume 时由 resume 返回给调用方,协程体内无法直接读取外部传入的新参数——需要动态喂参数时用 coroutine.yield 的接收侧语法(resume 的多余实参成为 yield 的返回值),这是双向通信的入口。

作者履历与出处

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

← 返回文章地图返回研学路径

最新技术文章 · 实战干货

LATEST ARTICLES

全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →

进阶实战游戏功能

帮会云梯:攻城架设的减伤突破

【游戏】 一、业务场景 攻城战守方工事减伤 24%,攻方撞门半小时毫无进展,双方都打得憋屈。云梯器械上线:攻方消耗 300 …

2026-09-27 06:15 996 技术组
进阶实战游戏功能

帮会铁券:违规抵罚的季度护身

【游戏】 一、业务场景 有成员误操作被按违规重罚,申诉三天才恢复,情面上过不去;也有人惯犯想靠求情免罚。铁券上线:1000 …

2026-09-27 06:15 996 技术组
高级技巧语法算法

Lua高斯消元:增广矩阵的逐列消元

【语法】 一、隐蔽陷阱 三元一次方程组手算消元:步骤繁、顺序乱还容易抄错系数;程序里按列从左到右系统地消成上三角再回代,解一…

2026-09-27 06:15 996 技术组
进阶实战语法算法

Lua矩形重叠:反向分离的相交判定

【语法】 一、隐蔽陷阱 判断两个矩形是否重叠:枚举所有角落两两比对要写八种情形,漏一种就误判;反向思考"不重叠"的条件只有四…

2026-09-27 06:15 996 技术组
进阶实战游戏功能

帮会粮票:票据面额的档位兑换

【游戏】 一、业务场景 帮会活动的奖励直接发物资:发多了通胀、发少了没感觉。粮票上线:活动改发票据,票据攒到面额兑换对应档物…

2026-09-27 06:15 996 技术组
高级技巧语法算法

Lua秦九韶算法:多项式的降次求值

【语法】 一、隐蔽陷阱 多项式 2x⁴+3x³+x²+5x+7 求值时逐项算幂再乘系数:每个 x 的幂都从头乘起,一个五项式…

2026-09-27 06:15 996 技术组