Arm64架构macOS（M3）下编译Apache2模块报错求助

问题本质 #

libaprutil-1.la is not a convenience library错误是因为libtool试图将非convenience类型的库（通常是静态库或标准共享库）当作convenience库链接，核心原因要么是Apache编译配置未生成正确的共享库，要么是apxs的链接参数存在偏差。

可行解决方案 #

1. 修正apxs编译命令 #

在apxs命令中显式指定共享库链接规则，强制使用动态链接：

apxs -c -Wl,-shared your_module.cpp -L/usr/local/apache2/lib -laprutil-1 -lapr-1 -L/opt/local/lib -lssl -lcrypto

• -Wl,-shared：告知链接器生成符合Apache要求的共享模块
• -L：指定库路径（macports安装的ssl默认在/opt/local/lib）
• -l：明确需要链接的依赖库

2. 重新编译Apache生成正确的共享库 #

如果上述方法无效，说明之前编译的Apache生成的是静态库，重新编译时添加明确的Arm64适配参数：

# 进入httpd-2.4.62源码目录
cd httpd-2.4.62
# 清理旧编译文件
make clean && rm -rf config.log config.status
# 配置编译参数
./configure \
  --prefix=/usr/local/apache2 \
  --enable-so \
  --with-apr=srclib/apr \
  --with-apr-util=srclib/apr-util \
  --with-ssl=/opt/local \
  --build=aarch64-apple-darwin$(sw_vers -productVersion | cut -d. -f1)
# 并行编译并安装
make -j$(sysctl -n hw.ncpu) && sudo make install

• --enable-so：强制启用Apache共享模块支持
• --build：明确指定Arm64架构，避免编译时的架构混淆
• --with-ssl：指定macports提供的ssl库路径

3. 直接修改原Makefile编译模块 #

若不想依赖apxs，直接在原Makefile中添加适配Arm64 macOS的编译规则：

MODULE_NAME = your_module
APACHE_INC = /usr/local/apache2/include
APACHE_LIB = /usr/local/apache2/lib
SSL_LIB = /opt/local/lib

$(MODULE_NAME).so: $(MODULE_NAME).cpp
	g++ -c -fPIC -I$(APACHE_INC) $(MODULE_NAME).cpp -o $(MODULE_NAME).o
	g++ -shared $(MODULE_NAME).o -L$(APACHE_LIB) -laprutil-1 -lapr-1 -lhttpd -L$(SSL_LIB) -lssl -lcrypto -o $(MODULE_NAME).so

install: $(MODULE_NAME).so
	sudo cp $(MODULE_NAME).so $(APACHE_LIB)/modules/
	sudo chmod 755 $(APACHE_LIB)/modules/$(MODULE_NAME).so

编译完成后，在httpd.conf中添加模块加载指令：

LoadModule your_module_module modules/your_module.so

4. 排查libaprutil-1.la文件 #

如果仍报错，打开/usr/local/apache2/lib/libaprutil-1.la检查：

• 若library_names字段只有.a后缀文件：说明是静态库，必须重新编译Apache生成共享库
• 若存在.dylib后缀文件：手动修改apxs生成的Makefile，将-laprutil-1替换为.dylib的绝对路径，比如：

  # 替换原链接参数
  /usr/local/apache2/lib/libaprutil-1.dylib
  

内容的提问来源于stack exchange，提问作者Phil. P.