Gradle构建时遭遇Nexus 401认证失败问题求助

1. 核对Gradle凭证配置细节 #

• 检查gradle.properties或settings.gradle中的凭证语法，确保无多余空格或错误包裹：

  nexusUsername=your-actual-username
  nexusPassword=your-actual-password
  

  若密码包含特殊字符（如@、$），需用单引号包裹或转义特殊字符
• 确认仓库配置中正确引用凭证：

  repositories {
      maven {
          url "http://your-nexus-instance:8081/repository/your-target-repo/"
          credentials {
              username nexusUsername
              password nexusPassword
          }
      }
  }
  

• 若用环境变量传递凭证，验证Gradle能读取到正确值（可通过gradle properties命令查看）

2. 验证Nexus侧权限与配置 #

• 登录Nexus控制台，检查对应用户是否拥有目标仓库的读取/写入权限（根据构建是拉取还是上传操作判断）
• 查看仓库的Deployment Policy设置，确认是否允许当前构建的操作（比如发布仓库是否允许重新部署）
• 查看Nexus日志（默认路径/opt/sonatype/nexus/sonatype-work/nexus3/log/nexus.log），搜索401相关条目，获取具体拒绝原因（如权限不足、凭证校验失败）

3. 排查Gradle与Nexus的兼容性问题 #

• 若Nexus启用HTTPS，检查Gradle是否信任其SSL证书：可临时添加allowInsecureProtocol = true到仓库配置测试（生产环境建议导入证书到JVM信任存储）
• Nexus 3.75可能禁用了弱加密协议（如TLS 1.0/1.1），确认Gradle使用的JDK版本支持TLS 1.2+，必要时添加JVM参数：org.gradle.jvmargs=-Dhttps.protocols=TLSv1.2,TLSv1.3
• 执行Gradle构建时添加--debug参数，对比curl请求的差异（如请求头、凭证编码方式、用户代理），定位请求中的异常点

4. 检查Azure虚拟机的网络干扰 #

• 确认Azure防火墙规则允许虚拟机访问Nexus的端口（默认8081）
• 若虚拟机使用代理，需在gradle.properties中配置代理信息：

  systemProp.http.proxyHost=proxy-host
  systemProp.http.proxyPort=proxy-port
  systemProp.http.proxyUser=proxy-user
  systemProp.http.proxyPassword=proxy-pass
  

• 尝试用gradle clean build --no-daemon命令构建，避免守护进程缓存旧凭证

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