使用jqassistant 2.4.0时Neo4J数据库意外关闭的解决咨询

1. 是否可以移除Neo4J依赖？ #

jqassistant的核心代码分析逻辑依赖Neo4J构建、存储和查询代码知识图谱，因此无法完全移除Neo4J依赖。不过可以通过配置切换到嵌入式内存模式，避免维护外部Neo4J实例，降低依赖运维成本——这种模式下Neo4J在内存中运行，任务结束后数据自动销毁，无需持久化到磁盘。

2. 解决jqassistant 2.4.0数据库关闭问题的方案 #

错误提示“所选目标存储格式'AF4.3.0'不再支持”，本质是jqassistant 2.4.0依赖的Neo4J版本（较2.0.10大幅升级）不再兼容旧版本的磁盘存储格式，按以下步骤修复：

• 清理旧存储文件
  删除项目根目录下的.jqassistant/neo4j目录，该目录是旧版本生成的兼容AF4.3.0格式的存储文件，新版本会重新生成适配当前Neo4J版本的存储文件。

• 调整存储配置
  修改.jqassistant.yml，可二选一：

  1. 切换到内存存储（推荐，彻底规避格式兼容问题）：

     store:
       type: in-memory
     

  2. 指定兼容的磁盘存储格式：
     查看jqassistant 2.4.0依赖的Neo4J版本对应的支持存储格式（一般为AF4.4.0及以上），在配置中明确指定：

     store:
       type: embedded
       configuration:
         dbms.directories.data: .jqassistant/neo4j/data
         dbms.record_format: aligned
         dbms.record_format_version: AF4.4.0
     

• 对齐依赖版本
  检查父POM中的Neo4J相关依赖，确保其版本与jqassistant 2.4.0内置的Neo4J版本一致，避免依赖冲突。如果父POM有统一的依赖管理，可在jqassistant插件配置中锁定Neo4J版本：

  <plugin>
    <groupId>com.buschmais.jqassistant</groupId>
    <artifactId>jqassistant-maven-plugin</artifactId>
    <version>2.4.0</version>
    <dependencies>
      <dependency>
        <groupId>org.neo4j</groupId>
        <artifactId>neo4j</artifactId>
        <version><!-- 填写jqassistant 2.4.0对应的Neo4J版本，比如5.11.0 --></version>
      </dependency>
    </dependencies>
  </plugin>
  

• 优化JVM参数
  在.mvn/jvm.config中增加足够的内存分配，比如：

  -Xmx4g -Xms2g
  

  新版本Neo4J对内存需求更高，内存不足会导致数据库意外关闭。

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