Ban transitive dependencies规则致WildFly 10.1.0.Final源码构建失败（曾可正常构建）

嘿，我刚好碰到过类似的问题，WildFly的Final版本肯定是能正常构建的，你遇到的这个冲突大概率不是源码本身的问题，而是依赖缓存或者环境变化导致的。下面给你几个排查和解决的步骤：

• 先清理本地Maven缓存
  本地Maven仓库里的依赖很容易因为缓存过期、损坏或者版本不一致触发这类规则冲突。执行这条命令强制清理并更新依赖：

  mvn clean install -U
  

  其中-U参数会强制Maven更新所有快照依赖，同时清理本地缓存里的旧依赖，很多时候这一步就能解决问题。

• 确认Maven版本是否符合要求
  WildFly 10.1.0.Final要求使用Maven 3.2.5及以上版本，低版本的Maven可能在依赖解析上有差异。你可以用mvn -v查看当前版本，如果版本不够，升级到符合要求的版本再尝试构建。

• 使用官方标准构建命令
  如果你之前加了自定义参数（比如私有仓库、额外的Enforcer规则），可能会干扰默认的依赖解析。先试试官方推荐的构建命令：

  mvn clean install -DskipTests
  

  -DskipTests是跳过测试加快构建速度，如果你想跑测试可以去掉这个参数，但冲突问题和测试无关，先跳过更高效。

• 排查具体冲突的依赖并强制指定版本
  如果上面的步骤都没用，仔细看构建日志，里面会明确指出哪个传递依赖触发了ban规则。找到这个依赖后，你可以在项目根目录的pom.xml里的<dependencyManagement>节点中添加一个条目，强制指定该依赖的版本为WildFly预期的版本，覆盖传递过来的版本。
  举个例子，如果冲突的是org.example:conflicting-dep:1.2.0，你可以这样加：

  <dependencyManagement>
      <!-- 其他依赖管理条目 -->
      <dependency>
          <groupId>org.example</groupId>
          <artifactId>conflicting-dep</artifactId>
          <version>1.1.0</version> <!-- WildFly源码中预期的版本 -->
      </dependency>
  </dependencyManagement>
  

• 检查是否有本地源码修改
  如果你之前修改过源码里的pom.xml，可能不小心改动了依赖配置导致规则触发。用git status看看有没有未提交的修改，或者直接重置到官方的10.1.0.Final标签：

  git reset --hard 10.1.0.Final
  

至于为什么之前能构建现在失败，原因很简单：Maven的依赖是从远程仓库拉取的，如果远程仓库里某个传递依赖的版本被更新，或者本地缓存的依赖损坏，就会导致原本符合规则的依赖变成不符合的，但WildFly的Final版本源码本身肯定是没问题的——毕竟是正式发布的版本，不可能连构建都通不过。

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