Apache httpd启动失败：加载mod_lua时报错Symbol not found: _ap_lua_init_mutex

嘿，我来帮你把这个报错拆解得明明白白，顺便说下背后的问题和解决方向：

错误本身的意思 #

这个报错本质是动态模块加载时的符号依赖缺失，逐句拆解：

• Cannot load /usr/local/lib/httpd/modules/mod_lua.so into server：Apache尝试加载你手动编译的mod_lua模块，但加载失败
• dlopen(...) Symbol not found: _ap_lua_init_mutex：系统调用dlopen（加载动态库的核心函数）时，找不到名为_ap_lua_init_mutex的符号——你可以把符号理解为模块需要调用的函数/全局变量的唯一标识
• Referenced from: mod_lua.so：这个缺失的符号是你的mod_lua.so模块必须用到的
• Expected in: flat namespace：系统在默认的全局符号空间里找这个符号，但完全没找到

为什么会出现这个问题？ #

结合你用Homebrew安装Apache的场景，大概率是以下两种情况：

1. 版本不匹配：你用来编译mod_lua的mod_lua.c源码，和Homebrew安装的httpd版本不一致。Homebrew的httpd可能是定制过的，或者不同Apache版本里的mod_lua依赖的符号名/实现有变化，导致当前httpd的核心库中根本没有_ap_lua_init_mutex这个符号
2. 编译时依赖链接错误：你用apxs编译时，可能没有正确关联Homebrew版httpd的开发库（头文件、核心库），导致编译出来的mod_lua.so没有正确绑定到httpd的符号上

解决办法 #

按优先级尝试：

• 先确认版本匹配：
  1. 先查你的httpd版本：httpd -v
  2. 确保你用的mod_lua.c是从完全相同版本的Apache源码包里提取的，绝对不要混用不同版本的源码文件
• 用Homebrew的apxs正确编译：
  1. 先确认你用的是Homebrew安装的apxs，而不是系统自带的：which apxs，应该输出/usr/local/bin/apxs（对应Homebrew的安装路径）
  2. 重新编译时，明确指定httpd的库和头文件路径：

     apxs -i -a -c -L/usr/local/lib/httpd -I/usr/local/include/httpd mod_lua.c
     

• 直接用Homebrew安装带Lua支持的httpd：
  如果你不想手动编译模块，可以直接让Homebrew安装带Lua支持的httpd：

  brew reinstall httpd --with-lua
  

  （如果--with-lua选项失效，可以看brew info httpd的输出，Homebrew可能调整了编译选项）
• 检查模块加载配置：
  打开httpd的配置文件（一般在/usr/local/etc/httpd/httpd.conf），确认LoadModule lua_module modules/mod_lua.so这一行没有重复，路径也和实际编译出来的mod_lua.so一致

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