MacOS下安装Maven依赖libx11失败：缺失stropts.h文件

问题 #

尝试通过Homebrew安装工作所需的Maven，但其依赖的libx11在执行make脚本时因缺失stropts.h文件编译失败，完整错误日志如下：

==> Installing maven dependency: libx11
==> ./configure --prefix=/Users/vmishel/homebrew/Cellar/libx11/1.8.4 --sysconfdir=/Users/vmishel/homebrew/etc
==> make
Last 15 lines from /Users/vmishel/Library/Logs/Homebrew/libx11/02.make:
/Users/vmishel/homebrew/Cellar/xtrans/1.5.0/include/X11/Xtrans/Xtranslcl.c:81:11: fatal error: 'stropts.h' file not found
libtool: compile:  clang -DHAVE_CONFIG_H -I. -I../../src -I../../include/X11 -I../../include -I../../include/X11 -I../../include -I../../include/X11 -I../../src/xcms -I../../src/xkb -I../../src/xlibi18n -I../../src -D_BSD_SOURCE -D_DEFAULT_SOURCE -D_BSD_SOURCE -DHAS_FCHOWN -DHAS_STICKY_DIR_BIT -I/Users/vmishel/homebrew/Cellar/libxau/1.0.11/include -I/Users/vmishel/homebrew/Cellar/libxdmcp/1.1.4/include -I/Users/vmishel/homebrew/Cellar/libxcb/1.15_1/include -I/Users/vmishel/homebrew/Cellar/xtrans/1.5.0/include -I/Users/vmishel/homebrew/Cellar/xorgproto/2022.2/include -I/Users/vmishel/homebrew/Cellar/xorgproto/2022.2/include -Wall -Wpointer-arith -Wmissing-declarations -Wformat=2 -Wstrict-prototypes -Wmissing-prototypes -Wnested-externs -Wbad-function-cast -Wold-style-definition -Wdeclaration-after-statement -Wunused -Wuninitialized -Wshadow -Wmissing-noreturn -Wmissing-format-attribute -Wredundant-decls -Werror=implicit -Werror=nonnull -Werror=init-self -Werror=main -Werror=missing-braces -Werror=sequence-point -Werror=return-type -Werror=trigraphs -Werror=array-bounds -Werror=write-strings -Werror=address -Werror=int-to-pointer-cast -Werror=pointer-to-int-cast -fno-strict-aliasing -g -O2 -c lcCharSet.c -o lcCharSet.o >/dev/null 2>&1
# include <stropts.h>
          ^~~~~~~~~~~
libtool: compile:  clang -DHAVE_CONFIG_H -I. -I../../src -I../../include/X11 -I../../include -I../../include/X11 -I../../include -I../../include/X11 -I../../src/xcms -I../../src/xkb -I../../src/xlibi18n -I../../src -D_BSD_SOURCE -D_DEFAULT_SOURCE -D_BSD_SOURCE -DHAS_FCHOWN -DHAS_STICKY_DIR_BIT -I/Users/vmishel/homebrew/Cellar/libxau/1.0.11/include -I/Users/vmishel/homebrew/Cellar/libxdmcp/1.1.4/include -I/Users/vmishel/homebrew/Cellar/libxcb/1.15_1/include -I/Users/vmishel/homebrew/Cellar/xtrans/1.5.0/include -I/Users/vmishel/homebrew/Cellar/xorgproto/2022.2/include -I/Users/vmishel/homebrew/Cellar/xorgproto/2022.2/include -Wall -Wpointer-arith -Wmissing-declarations -Wformat=2 -Wstrict-prototypes -Wmissing-prototypes -Wnested-externs -Wbad-function-cast -Wold-style-definition -Wdeclaration-after-statement -Wunused -Wuninitialized -Wshadow -Wmissing-noreturn -Wmissing-format-attribute -Wredundant-decls -Werror=implicit -Werror=nonnull -Werror=init-self -Werror=main -Werror=missing-braces -Werror=sequence-point -Werror=return-type -Werror=trigraphs -Werror=array-bounds -Werror=write-strings -Werror=address -Werror=int-to-pointer-cast -Werror=pointer-to-int-cast -fno-strict-aliasing -g -O2 -c imKStoUCS.c -o imKStoUCS.o >/dev/null 2>&1
libtool: compile:  clang -DHAVE_CONFIG_H -I. -I../../src -I../../include/X11 -I../../include -I../../include/X11 -I../../include -I../../include/X11 -I../../src/xcms -I../../src/xkb -I../../src/xlibi18n -I../../src -D_BSD_SOURCE -D_DEFAULT_SOURCE -D_BSD_SOURCE -DHAS_FCHOWN -DHAS_STICKY_DIR_BIT -I/Users/vmishel/homebrew/Cellar/libxau/1.0.11/include -I/Users/vmishel/homebrew/Cellar/libxdmcp/1.1.4/include -I/Users/vmishel/homebrew/Cellar/libxcb/1.15_1/include -I/Users/vmishel/homebrew/Cellar/xtrans/1.5.0/include -I/Users/vmishel/homebrew/Cellar/xorgproto/2022.2/include -I/Users/vmishel/homebrew/Cellar/xorgproto/2022.2/include -Wall -Wpointer-arith -Wmissing-declarations -Wformat=2 -Wstrict-prototypes -Wmissing-prototypes -Wnested-externs -Wbad-function-cast -Wold-style-definition -Wdeclaration-after-statement -Wunused -Wuninitialized -Wshadow -Wmissing-noreturn -Wmissing-format-attribute -Wredundant-decls -Werror=implicit -Werror=nonnull -Werror=init-self -Werror=main -Werror=missing-braces -Werror=sequence-point -Werror=return-type -Werror=trigraphs -Werror=array-bounds -Werror=write-strings -Werror=address -Werror=int-to-pointer-cast -Werror=pointer-to-int-cast -fno-strict-aliasing -g -O2 -c XDefaultIMIF.c -o XDefaultIMIF.o >/dev/null 2>&1
1 error generated.
make[3]: *** [xim_trans.lo] Error 1
make[3]: *** Waiting for unfinished jobs....
libtool: compile:  clang -DHAVE_CONFIG_H -I. -I../../src -I../../include/X11 -I../../include -I../../include/X11 -I../../include -I../../include/X11 -I../../src/xcms -I../../src/xkb -I../../src/xlibi18n -I../../src -D_BSD_SOURCE -D_DEFAULT_SOURCE -D_BSD_SOURCE -DHAS_FCHOWN -DHAS_STICKY_DIR_BIT -I/Users/vmishel/homebrew/Cellar/libxau/1.0.11/include -I/Users/vmishel/homebrew/Cellar/libxdmcp/1.1.4/include -I/Users/vmishel/homebrew/Cellar/libxcb/1.15_1/include -I/Users/vmishel/homebrew/Cellar/xtrans/1.5.0/include -I/Users/vmishel/homebrew/Cellar/xorgproto/2022.2/include -I/Users/vmishel/homebrew/Cellar/xorgproto/2022.2/include -Wall -Wpointer-arith -Wmissing-declarations -Wformat=2 -Wstrict-prototypes -Wmissing-prototypes -Wnested-externs -Wbad-function-cast -Wold-style-definition -Wdeclaration-after-statement -Wunused -Wuninitialized -Wshadow -Wmissing-noreturn -Wmissing-format-attribute -Wredundant-decls -Werror=implicit -Werror=nonnull -Werror=init-self -Werror=main -Werror=missing-braces -Werror=sequence-point -Werror=return-type -Werror=trigraphs -Werror=array-bounds -Werror=write-strings -Werror=address -Werror=int-to-pointer-cast -Werror=pointer-to-int-cast -fno-strict-aliasing -g -O2 -c XlcDL.c -o XlcDL.o >/dev/null 2>&1
libtool: compile:  clang -DHAVE_CONFIG_H -I. -I../../src -I../../include/X11 -I../../include -I../../include/X11 -I../../include -I../../include/X11 -I../../src/xcms -I../../src/xkb -I../../src/xlibi18n -I../../src -D_BSD_SOURCE -D_DEFAULT_SOURCE -D_BSD_SOURCE -DHAS_FCHOWN -DHAS_STICKY_DIR_BIT -I/Users/vmishel/homebrew/Cellar/libxau/1.0.11/include -I/Users/vmishel/homebrew/Cellar/libxdmcp/1.1.4/include -I/Users/vmishel/homebrew/Cellar/libxcb/1.15_1/include -I/Users/vmishel/homebrew/Cellar/xtrans/1.5.0/include -I/Users/vmishel/homebrew/Cellar/xorgproto/2022.2/include -I/Users/vmishel/homebrew/Cellar/xorgproto/2022.2/include -Wall -Wpointer-arith -Wmissing-declarations -Wformat=2 -Wstrict-prototypes -Wmissing-prototypes -Wnested-externs -Wbad-function-cast -Wold-style-definition -Wdeclaration-after-statement -Wunused -Wuninitialized -Wshadow -Wmissing-noreturn -Wmissing-format-attribute -Wredundant-decls -Werror=implicit -Werror=nonnull -Werror=init-self -Werror=main -Werror=missing-braces -Werror=sequence-point -Werror=return-type -Werror=trigraphs -Werror=array-bounds -Werror=write-strings -Werror=address -Werror=int-to-pointer-cast -Werror=pointer-to-int-cast -fno-strict-aliasing -g -O2 -c XDefaultOMIF.c -o XDefaultOMIF.o >/dev/null 2>&1
libtool: compile:  clang -DHAVE_CONFIG_H -I. -I../../src -I../../include/X11 -I../../include -I../../include/X11 -I../../include -I../../include/X11 -I../../src/xcms -I../../src/xkb -I../../src/xlibi18n -I../../src -D_BSD_SOURCE -D_DEFAULT_SOURCE -D_BSD_SOURCE -DHAS_FCHOWN -DHAS_STICKY_DIR_BIT -I/Users/vmishel/homebrew/Cellar/libxau/1.0.11/include -I/Users/vmishel/homebrew/Cellar/libxdmcp/1.1.4/include -I/Users/vmishel/homebrew/Cellar/libxcb/1.15_1/include -I/Users/vmishel/homebrew/Cellar/xtrans/1.5.0/include -I/Users/vmishel/homebrew/Cellar/xorgproto/2022.2/include -I/Users/vmishel/homebrew/Cellar/xorgproto/2022.2/include -Wall -Wpointer-arith -Wmissing-declarations -Wformat=2 -Wstrict-prototypes -Wmissing-prototypes -Wnested-externs -Wbad-function-cast -Wold-style-definition -Wdeclaration-after-statement -Wunused -Wuninitialized -Wshadow -Wmissing-noreturn -Wmissing-format-attribute -Wredundant-decls -Werror=implicit -Werror=nonnull -Werror=init-self -Werror=main -Werror=missing-braces -Werror=sequence-point -Werror=return-type -Werror=trigraphs -Werror=array-bounds -Werror=write-strings -Werror=address -Werror=int-to-pointer-cast -Werror=pointer-to-int-cast -fno-strict-aliasing -g -O2 -c lcCT.c -o lcCT.o >/dev/null 2>&1
make[2]: *** [all-recursive] Error 1
make[1]: *** [all] Error 2
make: *** [all-recursive] Error 1

Do not report this issue to Homebrew/brew or Homebrew/homebrew-core!

These open issues may also help:
libx11 1.8.5 https://github.com/Homebrew/homebrew-core/pull/132483
Installing maven has failed!

Homebrew推荐了libx11 1.8.5的相关更新，但尝试后编译libx11 1.8.5仍失败，寻求安装Maven或libx11的可行解决办法。

可行解决办法 #

办法一：跳过libx11依赖，直接安装Maven二进制包 #

Maven本身是Java应用，无需依赖X11库，可直接下载官方二进制包安装：

1. 下载对应版本的Maven二进制压缩包（如apache-maven-3.9.x-bin.tar.gz）
2. 解压到本地目录，例如/usr/local/maven
3. 配置环境变量：在~/.zshrc或~/.bash_profile中添加：

export MAVEN_HOME=/usr/local/maven
export PATH=$MAVEN_HOME/bin:$PATH

4. 执行source ~/.zshrc（或对应配置文件）使环境变量生效，运行mvn -v验证是否安装成功。

办法二：修复libx11编译问题 #

stropts.h是类Unix系统的头文件，在macOS中可通过以下方式解决缺失问题：

• 更新Xcode Command Line Tools到最新版本：

xcode-select --install
sudo xcode-select --reset

• 手动创建兼容的stropts.h头文件：
  1. 创建目录（若不存在）：sudo mkdir -p /usr/local/include
  2. 创建空头文件：sudo touch /usr/local/include/stropts.h
  3. 重新执行安装命令：brew install maven

办法三：强制使用Homebrew预编译二进制包 #

尝试跳过编译步骤，直接使用预编译的libx11包：

brew install --build-from-source=false libx11
brew install maven

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