升级Apache Commons Net至3.9.0后FTPSClient.listFiles()报错求助

异常本质 #

这个NoSuchMethodError是类路径冲突导致的：3.9.0版本的FTPSClient新增了返回java.time.Duration类型的getDataTimeout()方法，但你的运行环境中仍然存在旧版本（比如3.7.2）的commons-net jar，旧版本只有返回int的同名方法，导致JVM找不到新版本的方法。

核心解决步骤 #

• 排查依赖冲突：执行mvn dependency:tree命令，查看是否有其他依赖间接引入了旧版本的commons-net。如果有，在pom.xml的commons-net依赖中添加排除规则：

  <dependency>
      <groupId>commons-net</groupId>
      <artifactId>commons-net</artifactId>
      <version>3.9.0</version>
      <exclusions>
          <exclusion>
              <groupId>commons-net</groupId>
              <artifactId>commons-net</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• 清理构建环境：执行mvn clean install -U，强制清理本地缓存并重新构建，确保构建产物中只有3.9.0版本的jar。
• 检查运行环境：确认服务器、容器等运行环境的classpath中没有单独存放旧版本的commons-net jar，避免与新版本类冲突。

关于方法的疑问解答 #

• 不需要更换listFiles方法：该方法并未过时，异常和它本身无关，是类路径问题导致的。
• 无需添加额外依赖：commons-net 3.9.0是独立依赖，升级后已包含所有必要类，不需要额外引入其他包。
• 非过时的文件列表获取方法：
  • listFiles(String pathname, FTPFileFilter filter)：支持按过滤器筛选文件，功能更灵活；
  • listFiles(String pathname, FTPFilter filter)：基于Java 8的Predicate接口实现筛选；
  • 也可以使用initiateListParsing系列方法，但listFiles是更简便的常用选择。

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