知识库

解决依赖问题

包含 neo4j 制品有多种方式。本文将针对不同的场景或错误重点讨论基于 Maven 的做法。最常见的问题是未在 pom.xml 中正确设置依赖。

验证您拥有正确的依赖

您可以在包含 pom.xml 的文件夹中执行以下 Maven 命令

# resolve dependency in the local repository (by default in ~/.m2/)
$ mvn dependency:resolve

# displays the dependencies as a tree
$ mvn dependency:tree

# purge local repo and resolve dependencies
$ mvn dependency:purge-local-repository

# perform integration tests
$ mvn verify

在 3.5 版本中,即使运行单元测试,也只需要 3 个制品

对于 Enterprise 版,您的 pom.xml 应包含

pom.xml
<project>
  <!-- .... -->
  <properties>
    <neo4j.version>3.5.6</neo4j.version>
  </properties>
  <dependencies>
    <dependency>
       <groupId>com.neo4j</groupId>
       <artifactId>neo4j-enterprise</artifactId>
       <version>${neo4j.version}</version>
       <scope>provided</scope>
    </dependency>
    <dependency>
       <groupId>org.neo4j.driver</groupId>
       <artifactId>neo4j-java-driver</artifactId>
       <version>${neo4j-java-driver.version}</version>
       <scope>test</scope>
    </dependency>
    <dependency>
       <groupId>com.neo4j.test</groupId>
       <artifactId>neo4j-harness-enterprise</artifactId>
       <version>${neo4j.version}</version>
       <scope>test</scope>
    </dependency>
  </dependencies>
  <!-- ... -->
</project>

对于 Community 版,您的 pom.xml 应包含

pom.xml
<project>
  <!-- ... -->
  <properties>
    <neo4j.version>3.5.6</neo4j.version>
  </properties>
  <dependencies>
    <dependency>
      <groupId>org.neo4j</groupId>
      <artifactId>neo4j</artifactId>
      <version>${neo4j.version}</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>org.neo4j.driver</groupId>
      <artifactId>neo4j-java-driver</artifactId>
      <version>${neo4j-java-driver.version}</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>com.neo4j.test</groupId>
      <artifactId>neo4j-harness-enterprise</artifactId>
      <version>${neo4j.version}</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
  <!-- ... -->
</project>

使用配置为镜像仓库的私有 Sonatype Nexus 解析依赖

这是首选方案。它可以让您保持最新并自动获取更新。为此,需要以管理员身份登录 Nexus,或联系您的 Nexus 管理员,确保仓库可用且健康。

  • 对于 Community 版,您需要添加一个仓库

org.neo4j:neo4j,公共 Maven 仓库 URL 为 https://repo.maven.apache.org/maven2/

  • 对于 Enterprise 版,您需要添加以下两个仓库

com.neo4j:neo4j-enterprise(请参阅 “KB Dependency location for Neo4j Enterprise Edition artifacts” 获取 URL/用户名/密码)

org.neo4j:neo4j(在公共仓库 https://repo.maven.apache.org/maven2/ 上可用)

命名约定为 groupId:artifactId。例如:org.neo4j:neo4j 实际上是 groupId=org.neo4j 且 artifactId=neo4j

使用配置为托管仓库的私有 Sonatype Nexus 解析依赖

不推荐使用此方法,因为它需要手动操作且容易出错。应作为最后的解决方案使用。

请注意,Neo4j 需要的制品数量在 70 到 200 之间,具体取决于版本和使用的范围。

  • 最简便的实现方式是,在下载完所有依赖后压缩 .m2/repository 文件夹

  • 您需要将 JAR 包和对应的 pom 文件 都上传到您的仓库。

  • 在可访问官方仓库的机器上执行以下 Maven 命令并进行比较

$ mvn dependency:tree

如果发现差异,请使用浏览器浏览您的 Nexus 仓库并检查 .pom 文件的签名。

使用本地文件夹解析依赖(需要互联网)

这是最简便的方法,但您最终仍需重复这些步骤以升级到最新的维护版本。

  • 打开终端,进入包含 pom.xml 的项目文件夹

  • 使用以下 mvn 命令从可以上网的源机器下载 JAR 包,并将其复制到本地文件夹

mvn dependency:go-offline -Dmaven.repo.local=./remoterepo

(如果您的网络受限,可以请求支持来完成此操作)

  • 在源机器上压缩该文件夹

  • 在目标机器上解压

  • 在 pom.xml 中指定如下内容

pom.xml
<repositories>
  <repository>
    <id>neo4j</id>
    <url>file://</url>
    <!-- ie <url>file:///home/neo4j/maven/remoterepo</url> -->
  </repository>
  <repository>
    <id>neo4j-enterprise</id>
    <url>file://</url>
    <!-- ie <url>file:///home/neo4j/maven/remoterepoenterprise</url> -->
  </repository>
</repositories>
© . This site is unofficial and not affiliated with Neo4j, Inc.