Apache Xerces-Perl 在 Ubuntu 22.04 安装实录

在 Ubuntu 22.04 上实测 Apache Xerces-Perl（XML::Xerces 2.7.0-0）从 CPAN 与源码两条路径的完整安装链路，如实记录每一步的真实报错、三层变通尝试与最终结论，并给出清理方法。

Apache Xerces-PerlApache Xerces-PerlPerlXMLUbuntuUbuntu 22.042026/10/16

Apache Xerces-Perl 在 Ubuntu 22.04 安装实录

目标：在一台干净的 Ubuntu 22.04 服务器上，实测 Apache Xerces-Perl（CPAN 发行名 XML::Xerces）的完整安装链路：CPAN 自动安装与源码手工安装两条主线，覆盖 perl Makefile.PL、SWIG 胶水层生成、make 编译三个关键环节。这是一个 2006 年后停止维护的 Perl 绑定项目，本文的价值在于把现代工具链下的每一步真实报错、三层变通尝试与最终结论如实记录下来——无论是用于考古评估，还是用于决定是否继续投入，这份实录都能让你不必重走一遍弯路。XML::LibXML 替代方案与项目 API 面貌的详细评估见《Apache Xerces-Perl 评估与替代方案指南》。

一、环境信息

本文所有命令均在一台 Ubuntu 22.04 服务器上以 root 用户在 /root 目录下执行。基础环境如下：

$ head -3 /etc/os-release
PRETTY_NAME="Ubuntu 22.04.5 LTS"
NAME="Ubuntu"
VERSION_ID="22.04"
$ uname -m
x86_64
$ perl -v | head -2

This is perl 5, version 34, subversion 0 (v5.34.0) built for x86_64-linux-gnu-thread-multi
$ gcc --version | head -1
gcc (Ubuntu 11.4.0-1ubuntu1~22.04.3) 11.4.0
$ make -v | head -1
GNU Make 4.3

系统预装的关键软件包版本（dpkg -l 实测）：

软件包版本说明
libperl-dev5.34.0-3ubuntu1.9Perl 头文件与开发库，XS 编译必需
libxerces-c-dev3.2.3+debian-3ubuntu0.1apt 仓库提供的 Xerces-C++，仅 3.x 线
swig / swig4.04.0.2-1ubuntu1SWIG 接口生成器

其中 perl -v 输出中的 thread-multi 字样说明这是多线程构建的 Perl，后面分析编译报错时会再次用到这一信息。

二、前置条件与依赖

Apache Xerces-Perl 的完整安装链条有四个依赖点，缺一不可：

  1. Perl 5.6 以上（Ubuntu 22.04 自带 5.34，满足）；
  2. Xerces-C++ 2.7.0——注意不是 3.x：发行包的 Makefile.PL 有严格的版本硬检，后面会实测证明；
  3. SWIG 1.3 系列——README 明确声明 "This port will only work with SWIG 1.3.20"，发行包虽自带预生成的胶水层文件，但一旦需要重新生成就必须用 1.3 系；
  4. 编译工具链：gcc/g++、make、ar（Ubuntu 22.04 安装 build-essential 即齐）。

安装基础依赖：

# apt-get update
# apt-get install -y build-essential libperl-dev cpanminus

💡 技术拓展：Perl 与 C++ 库之间的绑定有两种主流实现方式。一是手写 XS——用 Perl 官方的 XS 宏语言逐函数编写胶水；二是用 SWIG——从 C++ 头文件自动生成胶水代码。XML::Xerces 选择的是 SWIG 路线，这决定了它对 SWIG 版本的强依赖：发行包里那份 7 万余行的预生成文件 Xerces.cpp 是 2005 年由 SWIG 1.3.28 pre-release 生成的（发行包 Changes 文件明确记载），SWIG 各版本生成的引导代码并不互通。

三、版本选型说明

动手之前先确认"装什么版本"。所有版本信息以下载页实测为准，不凭记忆或文档转述：

$ curl -sS https://archive.apache.org/dist/xerces/p/ | grep -oE 'XML-Xerces[^"<]*' | sort -u
XML-Xerces-2.7.0-0.tar.gz
XML-Xerces-2.7.0-0.tar.gz.asc

Apache 官方归档的 xerces/p 目录（Xerces-Perl 发行目录）实测只有 2.7.0-0 一个版本，即 2006 年初发布的最后一版。CPAN 侧同样如此，第五节的 cpanm 实测会显示它抓取的正是 XML-Xerces-2.7.0-0。

再实测 Xerces-C++ 依赖在归档中的可得性（后面会解释为什么这很关键）：

$ curl -sS https://archive.apache.org/dist/xerces/c/2/sources/ | grep -oE 'xerces-c-src_2_[0-9]_[0-9]\.tar\.gz' | sort -u
xerces-c-src_2_8_0.tar.gz

归档中 2.x 线源码包只剩 2.8.0，2.7.0 源码包已经不在 Apache 官方归档中了。版本选型结论：

组件应装版本归档实测状态
XML::Xerces2.7.0-0官方归档与 CPAN 均可得
Xerces-C++2.7.0（硬检指定）归档已无此版本，仅存 2.8.0
SWIG1.3 系（README 声明）官方已发 4.x，1.3 系需另行获取

四、获取官方源码包

从 Apache 归档下载并校验：

# mkdir -p /root/fresh-dl && cd /root/fresh-dl
# curl -sS -o XML-Xerces-2.7.0-0.tar.gz \
    https://archive.apache.org/dist/xerces/p/XML-Xerces-2.7.0-0.tar.gz
# ls -la
total 296
drwxr-xr-x 2 root root   4096 Oct 16 07:01 .
drwx------ 1 root root   4096 Oct 16 07:01 ..
-rw-r--r-- 1 root root 291199 Oct 16 07:01 XML-Xerces-2.7.0-0.tar.gz
# md5sum XML-Xerces-2.7.0-0.tar.gz
e5bd871026bee1b291c5634e6e4daf35  XML-Xerces-2.7.0-0.tar.gz
# tar tzf XML-Xerces-2.7.0-0.tar.gz | head -6
XML-Xerces-2.7.0-0/
XML-Xerces-2.7.0-0/interface/
XML-Xerces-2.7.0-0/interface/SAX2.i
XML-Xerces-2.7.0-0/interface/Perl/
XML-Xerces-2.7.0-0/interface/Perl/typemaps-xmlch.i
XML-Xerces-2.7.0-0/interface/Perl/typemaps.i

解压并进入源码目录：

# cd /root && tar xzf fresh-dl/XML-Xerces-2.7.0-0.tar.gz
# cd /root/XML-Xerces-2.7.0-0 && ls
Changes  COPYING  Handler  INSTALL  MANIFEST  META.yml  Makefile.PL
README   Xerces-extra.pm  Xerces.cpp  Xerces.i  Xerces.pm
docs  interface  samples  scripts  t

目录里的关键文件：Xerces.cpp 是 SWIG 预生成的 7 万行 C++ 胶水层；Xerces.pm 是 Perl 侧主模块；interface/ 存放 SWIG 接口定义文件；Handler/ 是 Perl 回调处理器的 C++ 实现子目录。

五、安装尝试一：CPAN 自动安装

先走最省事的路：cpanm 一键安装（cpanm 版本 1.7045）。

# cpanm -v XML::Xerces
You have not defined any of the following environment variables:
   XERCESCROOT
   XERCES_LIB
   XERCES_INCLUDE
...
Couldn't find XercesVersion.hpp in your include directory  at Makefile.PL line 188.
! Configure failed for XML-Xerces-2.7.0-0. See /root/.cpanm/work/1792134263.10400/build.log for details.
N/A

实测结论：cpanm 能正常取到 CPAN 上的 XML-Xerces-2.7.0-0（发行版仍在），但其 Makefile.PL 找不到 Xerces 头文件直接退出。即使指定环境变量绕过头文件探测，它也会撞上第六节的版本硬检，CPAN 路线在 Ubuntu 22.04 上走不通，必须转源码安装。

六、安装尝试二：源码安装主线

源码安装标准三步：perl Makefile.PL → （必要时 SWIG 重新生成）→ make。逐步实测。

6.1 第一步：perl Makefile.PL（apt 的 Xerces-C 3.2.3）

不设任何环境变量直接运行，Makefile.PL 会警告找不到头文件并退出（退出码 2）：

# unset XERCESCROOT XERCES_LIB XERCES_INCLUDE XERCES_CONFIG
# perl Makefile.PL
You have not defined any of the following environment variables:
   XERCESCROOT
   XERCES_LIB
   XERCES_INCLUDE
...
Couldn't find XercesVersion.hpp in your include directory  at Makefile.PL line 188.
# echo $?
2

指定 apt 安装的 Xerces-C 3.2.3 头文件与库路径再试：

# export XERCES_INCLUDE=/usr/include
# export XERCES_LIB=/usr/lib/x86_64-linux-gnu
# perl Makefile.PL
Using Xerces-C version info from /usr/include/xercesc/util/XercesVersion.hpp
      *** Version Mismatch ***

You are attempt to build XML::Xerces-2.7.0-0 using Xerces-C-3.2.3,
this will most likely fail, so I am aborting. 

You must use Xerces-C-2.7.0

# echo $?
255

第一个硬检出现：Makefile.PL 要求 Xerces-C++ 版本必须恰好等于 2.7.0，apt 仓库里的 3.2.3 直接被拒。这不是警告，是 die，退出码 255。

6.2 第二步：SWIG 胶水层生成（SWIG 4.0.2）

在跨过版本检查之前，先把另一个环节单独验证掉：如果将来需要重新生成胶水层，系统里的 SWIG 4.0.2 能不能用？在独立目录里试跑接口文件 Xerces.i：

# mkdir -p /root/swig4-try && cd /root/swig4-try
# cp /root/XML-Xerces-2.7.0-0/Xerces.i /root/XML-Xerces-2.7.0-0/Xerces-extra.pm .
# cp -r /root/XML-Xerces-2.7.0-0/interface .
# swig -perl5 -c++ -I/root/XML-Xerces-2.7.0-0/Handler \
    -I/root/xerces-c-src_2_8_0/include -o Xerces_wrap.cpp Xerces.i
interface/Perl/shadow.i:163: Error: Unknown SWIG preprocessor directive: $args (if this is a block of target language code, delimit it with %{ and %})
interface/Perl/shadow.i:163: Error: Unknown SWIG preprocessor directive: $args (if this is a block of target language code, delimit it with %{ and %})
# echo $?
1

$args 是 SWIG 1.3 时代支持的预处理器指令，4.x 已移除，接口文件不兼容，Xerces_wrap.cpp 未生成（exit 1）。结论与 README 的声明一致：必须用 SWIG 1.3 系。发行包自带的预生成 Xerces.cpp 因此成为唯一现成可用的胶水层——前提是先解决 Xerces-C 版本问题。

七、变通尝试与逐层突破

版本硬检要求 Xerces-C 2.7.0，而官方归档已不提供该版本源码（第三节实测）。按"最接近的官方版本"原则，尝试用归档仅存的 2.8.0 顶上，并逐层排障。

7.1 变通基础：源码自建 Xerces-C 2.8.0

从归档下载 xerces-c-src_2_8_0.tar.gz，解压后用其自带的 runConfigure 配置再构建（2005 年的构建系统，与现代 gcc 11 兼容性意外地好）：

# cd /root/xerces-c-src_2_8_0/src/xercesc
# ./runConfigure -plinux -cgcc -xg++ -minmem -tnative -rpthread
Generating makefiles with the following options ...
Platform: linux
C Compiler: gcc
C++ Compiler: g++
...
checking build system type... x86_64-unknown-linux-gnu
configure: creating ./config.status
config.status: creating Makefile
...
CONFIGURE_EXIT=0
# make includes        # 生成 include/ 头文件树
# make -j8
Building /root/xerces-c-src_2_8_0/lib/libxerces-c.so.28.0
...
MAKE_EXIT=0

构建成功。把 Xerces-C 2.8.0 交给 Makefile.PL：

# unset XERCES_INCLUDE XERCES_LIB XERCES_CONFIG
# export XERCESCROOT=/root/xerces-c-src_2_8_0
# perl Makefile.PL
Using XERCES_LIB = /root/xerces-c-src_2_8_0/lib
Using XERCES_INCLUDE = /root/xerces-c-src_2_8_0/include
using XERCES_CONFIG: /root/xerces-c-src_2_8_0/src/xercesc/config.status

Using Xerces-C version info from /root/xerces-c-src_2_8_0/include/xercesc/util/XercesVersion.hpp
      *** Version Mismatch ***

You are attempt to build XML::Xerces-2.7.0-0 using Xerces-C-2.8.0,
this will most likely fail, so I am aborting. 

You must use Xerces-C-2.7.0

# echo $?
255

版本硬检是逐字比较：2.8.0 也不行，必须 2.7.0。

7.2 变通一：版本号补丁骗过硬检

Xerces-C 的版本号定义在头文件 XercesVersion.hpp 的三个宏里。做最小侵入：把 MINOR 从 8 改成 7，让 Makefile.PL 以为这是 2.7.0（保留备份）：

# cp -p /root/xerces-c-src_2_8_0/include/xercesc/util/XercesVersion.hpp /root/XercesVersion.hpp.bak
# sed -i 's/#define XERCES_VERSION_MINOR 8/#define XERCES_VERSION_MINOR 7/' \
    /root/xerces-c-src_2_8_0/include/xercesc/util/XercesVersion.hpp
# grep -E '#define XERCES_VERSION_(MAJOR|MINOR|REVISION) ' /root/xerces-c-src_2_8_0/include/xercesc/util/XercesVersion.hpp | tail -3
#define XERCES_VERSION_MAJOR 2
#define XERCES_VERSION_MINOR 7
#define XERCES_VERSION_REVISION 0

重跑 Makefile.PL：

# export XERCESCROOT=/root/xerces-c-src_2_8_0
# perl Makefile.PL
...
Checking to see if libxerces is in your library path...Success!!
Using Xerces-C version: 2.7.0
Checking if your kit is complete...
Looks good
Writing MYMETA.yml and MYMETA.json
Generating a Unix-style Makefile
Writing Makefile for XML::Xerces
# echo $?
0

硬检通过，Makefile 生成。趁势编译：

# make -j4
/usr/bin/ar cr "../blib/arch/auto/Handler/Handler.a" PerlCallbackHandler.o \
    PerlContentCallbackHandler.o PerlDocumentCallbackHandler.o PerlErrorCallbackHandler.o
...（Handler 子目录编译通过后，Xerces.cpp 出现大量 -Wdelete-incomplete 警告，随后到达致命错误）
Xerces.cpp: At global scope:
Xerces.cpp:69331:1: error: too many initializers for 'swig_command_info'
69331 | };
      | ^
In file included from /usr/lib/x86_64-linux-gnu/perl/5.34/CORE/perl.h:5744,
                 from Xerces.cpp:736:
Xerces.cpp: In function 'void boot_XML__Xerces(PerlInterpreter*, CV*)':
Xerces.cpp:69557:58: error: 'struct swig_command_info' has no member named 'wrapper'
69557 |     newXS((char*) swig_commands[i].name,swig_commands[i].wrapper, (char*)__FILE__);
      |                                                          ^~~~~~~
make: *** [Makefile:348: Xerces.o] Error 1
# echo $?
2

失败点转移到了胶水层本身。这份 2005 年由 SWIG 1.3.28 pre-release 生成、面向 Perl 5.6 时代的引导代码，在 Perl 5.34 的 CORE 头文件下于模块引导注册处崩掉：swig_command_info 结构与命令表初始化、newXS 引导循环这三者的宏体系在两代 Perl 之间已经演化得不兼容。整个文件其余部分（7 万行）都只是警告，唯独引导注册表是硬错误——这意味着不是偶发的语法问题，而是生成代码与 Perl ABI 的代差。

7.3 变通二：源码自建 SWIG 1.3.40 重新生成

既然预生成胶水层与 Perl 5.34 不兼容，就用老 SWIG 重新生成。SWIG 1.3.40（2009 年）是 1.3 系的较新版本，从 SourceForge 取源码自建：

# curl -sSL -o swig-1.3.40.tar.gz \
    "https://downloads.sourceforge.net/project/swig/swig/swig-1.3.40/swig-1.3.40.tar.gz"
# tar xzf swig-1.3.40.tar.gz && cd swig-1.3.40
# ./configure --prefix=/opt/swig13 --without-tcl --without-python --without-java | tail -3
...
# make -j4 | tail -3
# ./swig -version | head -4

SWIG Version 1.3.40

Compiled with g++ [x86_64-unknown-linux-gnu]

意外顺利：SWIG 1.3.40 在 gcc 11 下能完成构建。直接用它生成（未安装前需指定 SWIG_LIB 指向源码内建的库目录，否则报 Unable to find 'swig.swg'）：

# export SWIG_LIB=/root/swig13/swig-1.3.40/Lib
# cd /root/XML-Xerces-2.7.0-0
# mv Xerces.cpp Xerces.cpp.orig        # 保留发行包原版
# /root/swig13/swig-1.3.40/swig -Wall -DXERCES_OLD -DXERCES_VERSION=2.7.0-0 \
    -I. -IHandler -I/root/xerces-c-src_2_8_0/include \
    -perl5 -c++ -shadow -o Xerces.cpp Xerces.i
/root/xerces-c-src_2_8_0/include/xercesc/util/XMLURL.hpp:35: Error: Syntax error in input(1).
# echo $?
1

接口文件会连带解析 Xerces-C 头文件，而 SWIG 1.3.40 的 C++ 解析器在 XMLURL.hpp 第 35 行的 class XMLUTIL_EXPORT XMLURL : public XMemory 处卡住——XMLUTIL_EXPORT 这类导出宏在 SWIG 的预处理上下文里未定义，被当成未知标识符。尝试直接把导出宏定义为空：

# /root/swig13/swig-1.3.40/swig ... -D'XMLUTIL_EXPORT=' -D'XMLPARSER_EXPORT=' ... \
    -perl5 -c++ -shadow -o Xerces.cpp Xerces.i
/root/xerces-c-src_2_8_0/include/xercesc/util/XercesDefs.hpp:286: Error: Macro 'XMLUTIL_EXPORT' redefined,
:1: Error: previous definition of 'XMLUTIL_EXPORT'.

命令行定义与头文件内部定义冲突。改定义更底层的叶子宏（头文件里 XMLUTIL_EXPORT 按条件展开为 PLATFORM_EXPORT 或 PLATFORM_IMPORT，把这两个叶子宏定义为空即可让所有导出宏自然消解）：

# /root/swig13/swig-1.3.40/swig -Wall -DXERCES_OLD -DXERCES_VERSION=2.7.0-0 \
    -D'PLATFORM_EXPORT=' -D'PLATFORM_IMPORT=' \
    -I. -IHandler -I/root/xerces-c-src_2_8_0/include \
    -perl5 -c++ -shadow -o Xerces.cpp Xerces.i
SWIG_GEN_EXIT=0
# ls -la Xerces.cpp
-rw-r--r-- 1 root root 2556701 Oct 16 07:08 Xerces.cpp

SWIG 1.3.40 生成成功了，产出 2.5 MB 新胶水层（发行包原版为 2382945 字节）。

7.4 终局：重生成胶水层仍然编译失败

用新生成的胶水层重新 make：

# make -j4
Handler/PerlEntityResolverHandler.i:116:54: error: 'SWIGTYPE_p_XERCES_CPP_NAMESPACE__InputSource' was not declared in this scope
Handler/PerlNodeFilterCallbackHandler.i:70:47: error: 'SWIGTYPE_p_XERCES_CPP_NAMESPACE__DOMNode' was not declared in this scope
Xerces.cpp:2258:55: error: 'SWIGTYPE_p_XERCES_CPP_NAMESPACE__XMLException' was not declared in this scope
...（同类错误共二十余处，覆盖 SAX/DOM/Grammar 各类类型）
Xerces.cpp:2315:14: error: 'SWIGTYPE_p_XERCES_CPP_NAMESPACE__DOMElement' was not declared in this scope; did you mean 'SWIGTYPE_p_XERCES_CPP_NAMESPACE__NameIdPoolT_DTDElementDecl_t'?
...
make: *** [Makefile:348: Xerces.o] Error 1
# echo $?
2

新的代差暴露了：发行包的接口文件与 Handler 回调代码里写死了 SWIGTYPE_p_XERCES_CPP_NAMESPACE__* 形式的 SWIG 类型描述符名（SWIG 1.3.28 pre-release 的命名习惯），而 SWIG 1.3.40 生成的是 SWIGTYPE_p_xercesc_2_7_* 形式（版本号补丁使头文件命名空间为 xercesc_2_7，SWIG 1.3.40 会把它展开进类型名）。两边对不上，类型描述符全线未声明。而且即便用脚本批量改名对齐，版本号补丁本身还会级联出更深的问题：Xerces-C 的命名空间名由版本宏派生，预编译的 libxerces-c.so.28.0 是以 xercesc_2_8 命名空间构建的，而重新生成的胶水层按 xercesc_2_7 引用符号——链接阶段必然出现成片未定义引用，除非把 Xerces-C 2.8.0 库也用改过的版本头完整重建一遍。

到这里，每解决一层问题就揭出下一层不兼容，维护成本已经远超收益，变通链到此为止。

八、失败根因分析与最终结论

把整条链路的阻塞点汇总：

#阻塞点真实报错可否绕过
1Makefile.PL 版本硬检只认 Xerces-C 2.7.0You must use Xerces-C-2.7.0（exit 255）可（版本号补丁）
2预生成胶水层与 Perl 5.34 引导 ABI 不兼容too many initializers for 'swig_command_info'、no member named 'wrapper'（exit 2）需重新生成
3SWIG 4.0.2 无法解析 1.3 时代接口文件Unknown SWIG preprocessor directive: $args（exit 1）可（自建 SWIG 1.3.40）
4SWIG 1.3.28 与 1.3.40 生成代码的类型描述符命名漂移SWIGTYPE_p_XERCES_CPP_NAMESPACE__XMLException was not declared（exit 2）理论可批量改名，但叠加命名空间级联问题，实际不可行

最终结论：在 Ubuntu 22.04（Perl 5.34 + gcc 11）上，XML::Xerces 2.7.0-0 无法构建出可用的 Xerces.so。 发行包的预生成胶水层死于 Perl ABI 代差，重新生成又受制于 SWIG 版本断代；三层变通（apt Xerces-C、版本号补丁、自建 SWIG 1.3.40）能把流程推进到 90% 位置，但最后一环的 SWIG 版本间漂移与命名空间级联使完整打通需要大规模代码手术，投入产出比完全不成立。该项目自 2006 年停更后从未适配现代 Perl/SWIG，工程上应视为不可用。替代方案实测见《Apache Xerces-Perl 评估与替代方案指南》。

💡 技术拓展：这次排障中真正"活着"的遗产是 Xerces-C 2.8.0 库本体——它在 gcc 11 下能完整构建，说明 2005 年代的 C++ 库源码兼容性尚可；真正断裂的是"语言绑定"这一层，因为绑定生成器（SWIG）与目标解释器（Perl）各自演化了十年以上。给老旧绑定项目续命的通用次序是：先确认胶水层可再生成（SWIG 版本兼容），再确认生成产物与解释器 ABI 兼容，最后才轮到库本体编译——XML::Xerces 恰好三环都断了。

九、卸载与清理

实测失败后，按以下步骤把服务器还原干净（版本号补丁与替换的胶水层必须恢复，否则留下脏状态）：

# cd /root/XML-Xerces-2.7.0-0
# make realclean                      # 清除 Makefile/blib 等构建产物
# mv -f Xerces.cpp.orig Xerces.cpp    # 恢复发行包原版胶水层
# cp -p /root/XercesVersion.hpp.bak \
       /root/xerces-c-src_2_8_0/include/xercesc/util/XercesVersion.hpp  # 还原版本头
# md5sum Xerces.cpp
8e5b3119e7959893e9457ee6783ca57f  Xerces.cpp
# tar xzf /root/XML-Xerces-2.7.0-0.tar.gz -O XML-Xerces-2.7.0-0/Xerces.cpp | md5sum
8e5b3119e7959893e9457ee6783ca57f  -
# rm -rf /root/XML-Xerces-2.7.0-0 /root/fresh-dl /root/swig4-try /root/xerces27-dl

md5 一致说明胶水层已还原为发行包原版。SWIG 1.3.40 若不再需要，删除 /root/swig13 与 /opt/swig13 即可；自建的 Xerces-C 2.8.0 位于 /root/xerces-c-src_2_8_0，整目录删除无残留（它从未执行过 make install）。

十、常见问题

Q1：为什么不能直接 cpanm XML::Xerces 装完？ Makefile.PL 除了找头文件外，还要求 Xerces-C 版本恰好为 2.7.0 并需要 Xerces-C 构建时的 config.status 文件，CPAN 自动安装无法满足这些前提。实测配置阶段即失败（Configure failed for XML-Xerces-2.7.0-0）。

Q2：用 apt 里的 libxerces-c-dev（3.2.3）为什么不行？ 版本硬检是字符串严格比较，3.x 与 2.7.0 不等直接中止。即使人工绕过，2.7 时代生成的胶水层引用的 DOMBuilder、Wrapper4DOMInputSource 等 API 在 3.x 中已删除，编译同样会失败。

Q3：版本号补丁（MINOR 8 改 7）有什么副作用？ 两个：一是 Makefile.PL 之后按 "2.7.0" 生成 Makefile，实际链接的是 2.8.0 库，行为差异无人背书；二是 Xerces-C 的 C++ 命名空间名（xercesc_2_7/xercesc_2_8）由版本宏派生，补丁会让新编译的胶水层与预编译库的符号命名空间错位，链接阶段爆出成片未定义引用。本文用它仅用于诊断推进。

Q4：既然 SWIG 1.3.40 能构建、也能生成胶水层，为什么不再往前推一把？ 因为类型描述符命名漂移（SWIGTYPE_p_XERCES_CPP_NAMESPACE__* vs SWIGTYPE_p_xercesc_2_7_*）出现在发行包接口文件与 Handler 子目录的写死引用里；要打通需同时改写接口文件、批量对齐生成代码、并用改版头文件重建 Xerces-C 库本体，这已经不是"安装"而是代码考古修复，超出合理投入。

Q5：生产环境需要 Xerces 风格的 XML 能力（SAX/DOM/校验），现在该用什么？ XML::LibXML（基于 libxml2），Ubuntu 22.04 上 apt-get install libxml-libxml-perl 即装即用，本文未能跑通的能力它都能覆盖，逐项对照实测见《Apache Xerces-Perl 评估与替代方案指南》。

十一、参考链接

  1. Apache 官方归档 Xerces-Perl 发行目录：https://archive.apache.org/dist/xerces/p/
  2. Apache 官方归档 Xerces-C 源码目录：https://archive.apache.org/dist/xerces/c/2/sources/
  3. XML::Xerces CPAN 页面：https://metacpan.org/pod/XML::Xerces
  4. XML::LibXML CPAN 页面：https://metacpan.org/pod/XML::LibXML
  5. SWIG 官方站点（1.3 系历史版本需经 SourceForge 归档获取）：https://www.swig.org/