Lua C插件编译成功但调用bar函数返回nil的问题排查

你的Lua C插件代码逻辑本身没问题，但模块入口函数的栈操作不符合Lua的规范，这才导致调用foo.bar返回nil。咱们一步步拆解问题：

问题根源 #

在luaopen_foo函数里，你执行了lua_setglobal(L, "foo")——这个操作会把栈顶的table弹出，赋值给全局变量foo，此时栈已经是空的了。但你紧接着return 1，告诉Lua这个函数要返回1个值，可栈上根本没有元素。这种矛盾会引发Lua的未定义行为：要么全局foo的table没有正确注册bar函数，要么foo本身就不是你预期的table，最终导致调用foo.bar得到nil。

两种修复方案 #

方案一：遵循Lua模块规范（推荐） #

去掉lua_setglobal，让模块table留在栈顶返回。这样用户可以通过require获取模块，更符合Lua的模块化最佳实践：

#include "lua.h"
#include "lualib.h"
#include "lauxlib.h"

static int bar (lua_State *L) {
 double arg1 = luaL_checknumber(L, 1);
 double arg2 = luaL_checknumber(L, 2);
 lua_Number res = arg1 + arg2;
 lua_pushnumber(L, res);
 return 1;
}

int luaopen_foo (lua_State *L) {
 static const struct luaL_Reg foo [] = {
 {"bar", bar},
 {NULL, NULL}
 };
 // luaL_newlib等价于lua_newtable + luaL_setfuncs，写法更简洁
 luaL_newlib(L, foo);
 // 栈顶就是模块table，直接返回1个值
 return 1;
}

在Lua中这样使用：

local foo = require("foo")
print(foo.bar(1, 2)) -- 此时会输出3.0

方案二：同时设置全局变量并返回模块table #

如果你一定要保留全局的foo变量，需要先复制栈顶的table，再设置全局，确保栈顶始终有模块table供Lua读取：

#include "lua.h"
#include "lualib.h"
#include "lauxlib.h"

static int bar (lua_State *L) {
 double arg1 = luaL_checknumber(L, 1);
 double arg2 = luaL_checknumber(L, 2);
 lua_Number res = arg1 + arg2;
 lua_pushnumber(L, res);
 return 1;
}

int luaopen_foo (lua_State *L) {
 static const struct luaL_Reg foo [] = {
 {"bar", bar},
 {NULL, NULL}
 };
 lua_newtable(L);
 luaL_setfuncs(L, foo, 0);
 // 复制栈顶的table，现在栈上有两个相同的table
 lua_pushvalue(L, -1);
 // 弹出一个table，设置为全局变量foo
 lua_setglobal(L, "foo");
 // 栈顶剩下的table作为模块返回值，符合规范
 return 1;
}

编译与加载注意事项 #

• 编译时要生成符合Lua命名规则的动态库：Linux下是foo.so，Windows下是foo.dll，macOS下是foo.dylib。
• 编译命令示例（Linux，假设Lua头文件在/usr/include/lua5.3）：

gcc -shared -fPIC -I/usr/include/lua5.3 foo.c -o foo.so

• 加载时确保模块在package.cpath指定的路径下，直接用require("foo")即可，不要手动用package.loadlib（除非你清楚自己在做什么）。

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