从Jenkins部署到Nexus时遇401未授权错误，如何解决？

一、先确认settings.xml是否是问题根源 #

401未授权大概率和settings.xml的认证配置直接相关，重点检查这几点：

• 检查servers节点下是否配置了对应Nexus仓库的认证信息，ID必须和pom.xml里distributionManagement的repository/id完全匹配：

<servers>
  <server>
    <id>nexus-releases</id>
    <username>你的Nexus用户名</username>
    <password>你的Nexus密码或令牌</password>
  </server>
</servers>

• 密码/令牌是否正确：如果用的是Nexus用户令牌，复制时别带多余空格；如果是密码，确认没过期或输错
• Jenkins用的是哪个settings.xml？全局配置路径一般是$JENKINS_HOME/maven/conf/settings.xml，项目级的要确认Jenkins任务里指定的路径没错

二、Nexus服务器端可能的问题 #

• 仓库权限没开：检查目标仓库（比如releases/snapshots）的Deployment Policy是否允许部署，同时确认用户有nx-repository-view-*-*-add和nx-repository-view-*-*-edit权限
• 用户状态异常：Nexus里的用户是否被禁用，或者密码/令牌过期
• 仓库URL写错：pom.xml里的repository URL要和Nexus仓库实际URL一致，比如别漏了/repository/前缀，正确格式是http://你的Nexus地址:8081/repository/nexus-releases/
• 反向代理拦截：如果Nexus挂了反向代理，确认代理没拦截认证请求，能正确传递凭据

三、快速解决401的步骤 #

1. 本地先测：在本地执行mvn deploy -s /path/to/settings.xml，如果本地能成功，说明问题出在Jenkins环境；如果本地也失败，直接查Nexus和settings.xml
2. 检查Jenkins凭据：如果Jenkins用凭据管理注入认证，确认凭据ID和settings.xml的server/id对应，且是“用户名+密码”类型
3. 看Nexus日志：去$NEXUS_HOME/log/nexus.log里搜401相关内容，日志会明确说“认证失败”还是“权限不足”
4. 临时用管理员测试：用Nexus管理员账号替换settings.xml里的凭据，能部署的话就是普通用户权限不够

四、稳定部署到Nexus的标准流程 #

• pom.xml正确配置distributionManagement：

<distributionManagement>
  <repository>
    <id>nexus-releases</id> <!-- 和settings.xml的server/id一致 -->
    <url>http://你的Nexus地址:8081/repository/nexus-releases/</url>
  </repository>
  <snapshotRepository>
    <id>nexus-snapshots</id>
    <url>http://你的Nexus地址:8081/repository/nexus-snapshots/</url>
  </snapshotRepository>
</distributionManagement>

• Jenkins任务配置：构建步骤选“调用顶层Maven目标”，目标填deploy，指定正确的settings.xml路径（或用Jenkins全局Maven配置）
• 用令牌替代密码：在Nexus用户设置里生成令牌，替换settings.xml的password字段，比明文密码更安全

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