Tarantool C++模块必须用extern "C"导出裸函数，init/gc签名固定，禁用C++异常、RAII和现代Lua绑定库，链接libtarantool并手动处理Lua C API交互。
tarantool C++ 模块必须用 C ABI 导出函数
tarantool 的模块加载器只认 C 风格符号，任何 extern "C" 以外的函数（包括类成员、模板实例、重载函数）都无法被 box.module.load() 找到。哪怕你用 C++ 写了完整逻辑，入口点也得是裸 C 函数。
- 所有导出函数必须用
extern "C" { ... }包裹，否则链接时符号名会被 mangling，tarantool 查不到 -
init和gc回调函数签名固定：int init(struct lua_State *L)、void gc(void *data)，不能加const或引用修饰 - 别在
init里做耗时初始化（比如连接数据库），它在 Lua 加载时同步执行，会卡住整个实例
lua_State 交互必须用 C API，不能直接用 sol2 / lua-bindings
tarantool 自带的 Lua 是修改过的 Lua 5.1 分支（lua-5.1.5-tarantool），不兼容现代 C++ 绑定库的 ABI 和类型系统。sol2、tolua++、luabind 等默认编译失败或运行时崩溃。
- 读参数只能用
lua_isstring(L, 1)、lua_tointeger(L, 2)这类 C API，别尝试把lua_State*传给 sol2 的sol::state_view - 返回值必须手动
lua_pushstring(L, "ok")、lua_pushnumber(L, 42)，不能依赖 RAII 自动压栈 - 错误必须用
luaL_error(L, "msg")抛出，返回LUA_ERRRUN之类的状态码 tarantool 不识别
编译时链接 libtarantool 而非 libtnt 或 libtarantool-core
官方文档里提到的 libtnt 是旧版客户端库，跟模块开发无关；libtarantool-core 是内部静态库，没导出 symbol 表。真正要链接的是 tarantool 安装目录下的 libtarantool.so（或 .a）。
- 编译命令里必须有
-ltarantool，且-L/path/to/tarantool/lib要指向包含该 so 的目录 - 头文件路径用
-I/path/to/tarantool/include，里面必须有module.h、lua/utils.h等，缺一个就编译不过 - 如果用
cmake，别直接find_package(Tarantool)—— 官方没提供 config 文件，得手动find_library(TARANTOOL_LIB tarantool PATHS ...)
模块加载后 Lua 层看不到 C++ 异常，崩溃会静默退出
tarantool 的模块 loader 不捕获 C++ 异常。一旦你的代码抛出 std::runtime_error，进程直接 abort，日志里只有一行 Segmentation fault (core dumped)，没有任何堆栈。
- 所有可能 throw 的地方（比如
std::string::substr、dynamic_cast失败）必须用try/catch(...)包住，并转成luaL_error - 别在模块全局作用域里 new 对象 —— 构造函数异常无法拦截，模块加载直接失败
- 用
tarantool -v启动，看是否打印module: loaded；没这句说明 init 函数根本没跑完
最麻烦的不是写代码，是让 tarantool 在加载时既不崩溃、也不静默吞掉错误。每次改完 C++ 模块，先用 ldd -r your_module.so | grep undefined 检查符号缺失，再确认 tarantool -e "require'your_module'" 是否报错 —— 错误信息在哪一行，往往就暴露在哪一个 C ABI 细节上。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
