Travis-CI 部署至Sonatype失败，多模块Java Maven项目求助

Hey Roger, 既然你单模块项目在Travis-CI上的构建和部署都完全正常，那多模块项目的失败大概率出在构建/部署阶段的顺序控制或者子模块的配置细节上——毕竟手动部署和CI环境下的多模块执行逻辑还是有差异的。结合你的情况（POM合规、密钥齐全），我整理了几个最值得优先排查的方向：

1. 确保Travis只在整个项目构建完成后执行部署 #

多模块项目很容易踩的坑是：Travis默认可能会在每个子模块构建完成后就触发部署，而不是等所有子模块都install完成后，由父模块统一执行部署流程。

• 解决办法：在.travis.yml里明确绑定部署到整个构建完成之后，并且限定只在父模块的构建目录下执行。示例配置：

  script: mvn clean deploy -DskipTests
  deploy:
    skip_cleanup: true
    on:
      branch: master
      condition: $TRAVIS_BUILD_DIR = "$TRAVIS_REPO_SLUG"
  

  另外，也可以在Maven命令里用-pl参数指定只针对需要部署的子模块执行，避免无意义的部署尝试。

2. 检查子模块的部署跳过配置 #

手动部署时你可能会针对性地处理子模块，但CI环境下会严格按照POM配置执行。如果你的项目里有不需要部署的子模块（比如pom类型的聚合模块），必须明确跳过它们的部署流程：

• 在这类子模块的pom.xml里添加全局跳过配置：

  <properties>
    <maven.deploy.skip>true</maven.deploy.skip>
  </properties>
  

• 同时确认需要部署的子模块都正确继承了父模块的distributionManagement配置，没有因为局部覆盖导致指向错误的Nexus仓库。

3. 验证CI环境下的密钥与权限传递 #

虽然你本地的密钥和权限没问题，但Travis环境下，多模块构建时环境变量可能存在传递不完整的情况，导致子模块部署时出现权限验证失败：

• 确保SONATYPE_USERNAME、SONATYPE_PASSWORD这类核心环境变量是全局声明的，在.travis.yml里配置：

  env:
    global:
      - SONATYPE_USERNAME=your-sonatype-username
      - SONATYPE_PASSWORD=your-sonatype-password
  

• 检查Travis使用的settings.xml（可以通过before_install阶段注入），确保其中配置的Nexus服务器id和POM里distributionManagement的id完全一致，否则Maven会找不到对应的认证信息。

4. 排查子模块的签名或构建产物问题 #

多模块部署时，任何一个子模块的构建失败（比如GPG签名失败）都会导致整个部署流程中断，而这类问题在手动部署时可能被你忽略了：

• 去Travis的构建日志里定位具体失败的子模块，重点找gpg: signing failed、401 Unauthorized或者403 Forbidden这类关键错误信息。
• 如果是签名问题，确保Travis里的GPG密钥已经正确导入，并且gpg-passphrase环境变量配置无误。可以在before_install阶段添加密钥导入脚本，避免多模块签名时出现缓存问题：

  echo "$GPG_SECRET_KEYS" | base64 --decode | gpg --import
  echo "$GPG_OWNERTRUST" | base64 --decode | gpg --import-ownertrust
  

5. 避免父模块的无意义部署尝试 #

如果你的父模块是pom类型的聚合模块，本身不需要部署到Nexus，那Travis尝试部署它就会直接失败：

• 在父模块的pom.xml里直接禁用部署插件：

  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-deploy-plugin</artifactId>
        <configuration>
          <skip>true</skip>
        </configuration>
      </plugin>
    </plugins>
  </build>
  

按照这个思路排查，应该能快速定位到问题所在——毕竟你已经有单模块成功的经验，多模块的问题大多是流程控制或子模块配置的细节问题。

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