Jenkins 2.332.3因找不到父POM无法解析POM导致构建失败

该故障是Jenkins 2.332.3默认绑定的Maven Integration插件行为变更导致，和Maven版本、Nexus服务、本地缓存本身无关：

1. Maven类型任务的Parsing POMs是在所有构建/预构建步骤之前执行的独立流程，这个流程默认不会加载你给后续Maven构建步骤配置的自定义settings.xml，只会读取Maven安装目录下的默认全局配置，完全识别不到私有Nexus仓库地址，只会默认请求中央仓库查找父POM，必然报找不到的错误。
2. 预构建步骤能跑通，是因为预构建步骤调用的Maven进程会正常加载你配置的私服settings，但POM解析是整个任务的第一个执行环节，解析失败直接终止任务，根本轮不到预构建步骤执行。你之前测到预构建能成功，是调整执行顺序后的结果，不代表解析阶段能读取到对应配置。
3. 加-U、-X参数无效是因为这些参数只会传递给后续正式构建阶段的Maven进程，不会作用于前置的POM解析流程，所以日志不会有任何变化。
4. 旧版Jenkins 2.263.4运行正常，是因为其绑定的旧版Maven Integration插件默认会继承全局Maven的settings配置，这个逻辑在插件3.10及以上版本被修改为默认不继承，必须手动指定。
5. 你判断父POM已经存在于本地.m2仓库但解析还是失败，还有一个可能：如果任务开启了「Use private Maven repository for this build」配置，POM解析阶段会使用任务工作目录下的独立私有仓库，不会读取用户目录下的默认.m2缓存。

• 修正POM解析阶段的配置生效问题
  进入任务配置页，找到Maven构建模块专属的「Settings file」配置项，不要选择默认的(Default)选项，手动指定配置了Nexus私服地址的settings文件：如果用Config File Provider插件统一管理配置，直接下拉选择已录入的对应settings文件；如果是节点本地存放的配置文件，填写配置文件在节点上的绝对路径即可。如果开启了任务私有仓库选项，要么关闭该选项复用默认本地仓库，要么确保settings配置对解析阶段生效。
• 修复本地仓库权限
  确认Jenkins运行用户对本地Maven仓库目录有完整读写权限，高版本Jenkins默认以jenkins用户运行，如果之前用root用户执行过构建导致仓库目录属主变更为root，会导致解析阶段无法读取已缓存的父POM，执行以下命令修复权限即可：

  chown -R jenkins:jenkins ~jenkins/.m2/repository
  

• 校验POM父模块配置
  检查当前项目POM中<parent>节点下的<relativePath>配置，如果父POM不在当前项目代码的相对路径下，直接配置为空标签<relativePath/>，强制解析流程从Maven仓库拉取父POM，避免优先读取本地错误路径的无效文件。
• 临时绕过方案
  如果不需要用到Maven类型项目的专属特性（比如自动识别多模块、增量构建），直接把任务类型修改为自由风格项目，将Maven构建配置为普通构建步骤，即可完全绕过前置POM解析逻辑，和你之前预构建步骤跑通的执行逻辑完全一致，构建结果不会有差异。

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