Gradle添加Aspose Cells依赖无法正常工作问题求助

问题说明 #

Gradle项目中添加Aspose Cells依赖后无法正常生效，相关参考素材如下：

排查修复步骤 #

• 补全Aspose官方仓库配置
  Aspose正式发行包未托管在Maven中央仓库，绝大多数依赖拉取失败问题都是漏配专属仓库导致。在build.gradle的repositories代码块中添加Aspose官方Maven仓库地址：

  repositories {
      mavenCentral()
      maven { url "https://releases.aspose.com/java/repo/" }
  }
  

• 核对依赖坐标
  检查dependencies代码块中的Aspose Cells依赖坐标拼写，标准写法参考如下，版本号可按需替换为目标版本：

  dependencies {
      implementation 'com.aspose:aspose-cells:24.7'
  }
  

• 强制刷新依赖缓存
  配置修改后执行命令清除本地错误缓存，强制重新拉取依赖：

  # Linux/macOS
  ./gradlew build --refresh-dependencies
  # Windows
  gradlew.bat build --refresh-dependencies
  

  使用IntelliJ IDEA开发时，可直接点击Gradle侧边栏的刷新按钮触发全量依赖同步。
• 校验运行环境配置
  检查IDE中Gradle配置，确认离线工作模式未开启：打开Settings > Build, Execution, Deployment > Build Tools > Gradle，取消勾选Offline work选项。
  若处于公司内网存在代理限制，无法直接访问Aspose官方仓库，可手动下载对应版本的jar包存入项目libs目录，通过本地文件方式引入依赖：

  dependencies {
      implementation files('libs/aspose-cells-24.7.jar')
  }
  

若上述操作后仍存在依赖解析错误，进入本地Gradle缓存默认路径~/.gradle/caches/modules-2/files-2.1/com.aspose/，删除对应版本的损坏缓存文件后重新执行同步即可。

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