Grails 3中FilenameUtils缺失问题求助（插件升级场景）

你完全不用手动复制适配整个FilenameUtils类，Apache Commons IO是成熟的第三方工具库，直接通过依赖引入就能解决问题。你添加依赖后仍无法引入的情况，大概率是依赖配置或同步环节出了问题，咱们一步步来排查解决：

• 确认依赖配置的正确位置：Grails 3基于Gradle构建，依赖必须放在项目根目录的build.gradle文件的dependencies代码块内，正确的配置示例如下（建议用最新稳定版，比2.6的兼容性更好）：

  dependencies {
      // 保留你原有的其他依赖
      implementation 'commons-io:commons-io:2.15.1'
  }
  

  注：Grails 3后期版本推荐用implementation替代compile，不过compile也能正常生效。

• 强制同步Gradle依赖：添加依赖后，需要触发Gradle下载并引入该库。你可以：

  • 在IDE（如IntelliJ/Eclipse）中点击"Sync Project with Gradle Files"按钮；
  • 或者在项目根目录执行终端命令：

    ./gradlew build --refresh-dependencies
    

• 清理IDE缓存：有时候IDE的缓存会导致依赖无法被识别，你可以尝试：

  • IntelliJ：File -> Invalidate Caches...，勾选"Clear file system cache and local history"后重启IDE；
  • Eclipse：Project -> Clean...，选择你的项目后执行清理。

• 验证依赖是否成功引入：执行./gradlew dependencies命令，在输出的依赖树中查找commons-io，确认它已经被正确包含进来。

• 备选方案：使用JDK/Grails内置工具类：如果上述方法都不生效，也可以用JDK自带的路径处理API替代，功能和FilenameUtils.concat()完全一致：

  import java.nio.file.Paths
  Paths.get(path, it).toString()
  

优先推荐通过依赖引入Apache Commons IO的方式，这样后续库的版本更新和维护都不用自己操心。

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