使用luaunit进行Lua单元测试时出现err_msg索引nil值错误的原因排查

我之前调试LuaUnit测试时也踩过这个坑，结合源码和实际排查经验，这个错误通常是因为LuaUnit在处理测试错误时，拿到了nil的错误消息，然后尝试对这个nil值做字符串索引操作（比如调用err_msg:match()或err_msg:sub()）导致的。具体可能的原因有这些：

• 测试代码抛出了无消息的错误
  如果你在测试里直接调用error(nil)，或者自定义的断言函数返回nil作为错误信息，LuaUnit捕获错误时就会拿到nil的err_msg。比如：

  function test_empty_error()
    -- 错误写法：没有提供错误消息
    error(nil)
    -- 或者自定义断言里返回nil
    local function my_assert(cond)
      if not cond then return nil end
    end
    my_assert(false)
  end
  

  这种情况下，LuaUnit后续处理错误消息的代码就会因为索引nil而崩溃。

• Lua版本与LuaUnit版本不兼容
  某些旧版本的LuaUnit（比如0.8.x之前的版本）在适配不同Lua版本（比如Lua 5.1 vs Lua 5.3）的错误捕获逻辑时存在缺陷，当虚拟机抛出某些底层错误时，无法正确提取错误消息，导致err_msg为nil。建议尝试升级到最新稳定版的LuaUnit，或者确认你的Lua版本在LuaUnit的兼容列表里。

• 触发了无消息的底层错误
  如果你的测试代码调用了某些C扩展函数，或者触发了Lua虚拟机的底层错误（比如内存分配失败、无效的C函数调用），这类错误可能不会携带字符串消息，LuaUnit捕获到的err_msg就是nil，进而触发索引错误。

• 自定义错误处理逻辑干扰了错误捕获
  如果你在测试代码里重写了debug.traceback，或者修改了LuaUnit的错误处理钩子函数，导致错误消息被意外清空或返回nil，也会出现这个问题。比如：

  -- 错误示例：重写traceback返回nil
  local original_traceback = debug.traceback
  debug.traceback = function() return nil end
  

解决思路也很直接：先检查测试代码里所有抛出错误的地方，确保都提供了非nil的错误消息；如果是版本兼容问题，升级LuaUnit或调整Lua版本；最后排查是否有自定义的错误处理逻辑干扰了LuaUnit的正常工作。

内容的提问来源于stack exchange，提问作者Chris Merck