WSO2 API Manager 4.2.0源码构建PKIX错误求助及构建文档咨询

尝试构建WSO2 API Manager wso2am-4.2.0版本时，在<PRODUCT_HOME>\modules\distribution\product目录执行mvn clean install命令，出现以下错误：

The project org.wso2.am:wso2am:4.2.0 (D:\APIM 4.2.0\product-apim-4.2.0\modules\distribution\product\pom.xml) has 1 error
[ERROR] Non-resolvable parent POM for org.wso2.am:am-parent:4.2.0: Could not transfer artifact org.wso2:wso2:pom:1.3 from/to wso2-nexus (https://maven.wso2.org/nexus/content/groups/wso2-public/): PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target and 'parent.relativePath' points at wrong local POM @ org.wso2.am:am-parent:4.2.0, D:\APIM 4.2.0\product-apim-4.2.0\pom.xml, line 31, column 13 -> [Help 2]

已完成Maven路径配置，且按文档设置了MAVEN_OPTS变量，现咨询两个问题：

1. 如何解决该问题？
2. 是否有更详细的产品构建文档？

1. 解决PKIX证书及父POM依赖问题 #

该错误由两个核心问题导致：Maven无法验证WSO2 Nexus仓库的SSL证书，同时本地父POM的相对路径配置错误。可按以下步骤逐一修复：

导入WSO2 Nexus仓库SSL证书到JVM信任库 #

• 访问WSO2 Nexus仓库地址，通过浏览器导出网站的SSL证书（格式选择DER或PEM）。
• 定位本地JDK的信任库路径，通常为<JDK_HOME>/jre/lib/security/cacerts，默认信任库密码为changeit。
• 使用keytool命令导入证书，替换命令中的路径为你的实际路径：

  keytool -import -alias wso2-nexus-cert -file /path/to/downloaded/certificate.cer -keystore <JDK_HOME>/jre/lib/security/cacerts
  

  执行命令时输入信任库密码，确认完成证书导入。

修正父POM的相对路径配置 #

打开D:\APIM 4.2.0\product-apim-4.2.0\pom.xml文件，定位到第31行的<parent>节点，调整relativePath属性值，确保它指向正确的本地父POM文件。例如，如果父POM位于当前文件的上级目录，可修改为：

<parent>
    <groupId>org.wso2.am</groupId>
    <artifactId>am-parent</artifactId>
    <version>4.2.0</version>
    <relativePath>../pom.xml</relativePath>
</parent>

清理Maven缓存并重新构建 #

执行以下命令清理Maven本地缓存，强制更新依赖后重新构建：

mvn clean install -U

2. 详细产品构建文档 #

WSO2官方提供了针对API Manager 4.2.0版本的完整构建指南，涵盖环境前置要求（JDK、Maven版本等）、源码获取、分模块/全量构建命令、常见问题排查等内容。你可以在WSO2官方文档库中找到对应版本的构建文档，里面的步骤比通用Maven配置文档更贴合产品特性。

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