Lua版本不兼容：LuaLaTeX无法加载luasql-sqlite3模块的解决咨询

核心问题分析 #

你遇到的undefined symbol: lua_tointeger错误，本质是Lua版本不匹配：终端使用Lua5.1，luarocks为其编译了luasql-sqlite3；但LuaLaTeX集成的是Lua5.3，两者C API符号（如lua_tointeger在Lua5.1中名为lua_tointegerx）不兼容，导致模块加载失败。

你的疑问解答 #

1. 是否有适配Lua5.3的luasql版本？ #

有。luasql-sqlite3本身支持Lua5.1至5.4版本，只需针对Lua5.3重新编译安装即可，无需更换luasql分支。

2. 能否指定LuaLaTeX使用的Lua解释器版本？ #

不能。LuaLaTeX的Lua解释器是与TeX发行版（如TeX Live/MiKTeX）绑定编译的，无法单独替换为系统中的其他Lua版本，只能使用其内置的Lua环境。

更优解决方案（无需卸载旧Lua版本） #

不用卸载系统原有Lua5.1/5.2，通过luarocks的版本控制功能，为Lua5.3单独安装适配的luasql-sqlite3：

步骤1：安装Lua5.3开发依赖 #

sudo apt install liblua5.3-dev

步骤2：针对Lua5.3安装luasql-sqlite3 #

有两种可选方式：

• 方式一：指定Lua路径编译
  直接用系统luarocks，通过--lua-dir参数指定Lua5.3的开发库路径：

  sudo luarocks install luasql-sqlite3 SQLITE_INCDIR=/usr/include --lua-dir=/usr/lib/x86_64-linux-gnu/lua/5.3/
  

• 方式二：安装luarocks5.3（推荐）
  若系统包管理器提供luarocks5.3（如Debian/Ubuntu），直接安装并使用它：

  sudo apt install luarocks5.3
  sudo luarocks5.3 install luasql-sqlite3 SQLITE_INCDIR=/usr/include
  

步骤3：在LaTeX中正确加载模块 #

• 推荐：使用luapackageloader
  确保在\directlua前加载该包，它会自动识别luarocks为Lua5.3安装的模块路径：

  \usepackage{luapackageloader}
  \directlua{
      local luasql = require("luasql.sqlite3")
      -- 后续数据库操作
  }
  

• 手动指定路径（备用）
  若luapackageloader未生效，手动添加Lua5.3的模块路径：

  \directlua{
      package.cpath = "/usr/local/lib/lua/5.3/luasql/sqlite3.so;" .. package.cpath
      local luasql = require("luasql.sqlite3")
  }
  

验证方法 #

在LaTeX中添加以下代码，确认模块加载成功：

\directlua{
    print("Lua version:", _VERSION)
    local ok, luasql = pcall(require, "luasql.sqlite3")
    print("luasql loaded:", ok)
}

编译后查看日志，若输出Lua version: Lua 5.3和luasql loaded: true则说明配置正确。

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