使用Neo4j APOC导入JSON Lines时遇NullPointerException问题排查

问题原因 #

你遇到的NullPointerException是因为nodePropertyMappings的配置格式不正确，导致APOC在解析映射规则时无法获取有效的属性名称（即错误中的name字段）。当映射规则缺失必要的配置项或路径指定错误时，就会触发这个异常。

正确的映射配置 #

要将Earthquake节点的coordinates嵌套属性转换为Neo4j的Point类型，需要在nodePropertyMappings中明确指定Point类型的坐标来源路径。正确的调用语句如下：

CALL apoc.import.json("file:///your-file-path.json", {
  nodePropertyMappings: {
    "Earthquake": {
      "coordinates": {
        "type": "point",
        "config": {
          "latitude": "properties.coordinates.latitude",
          "longitude": "properties.coordinates.longitude",
          "height": "properties.coordinates.height"
        }
      }
    }
  }
})

关键说明 #

• config字段是Point类型映射的必要项，必须通过完整路径指定纬度、经度（和高度）的来源，路径基于JSON节点对象的结构（比如properties.coordinates.latitude对应JSON中properties下的coordinates子对象里的latitude值）。
• 若省略config或路径指定错误，APOC无法正确解析坐标数据，进而触发空指针异常。
• 你之前移除映射参数或映射不存在的标签时导入正常，是因为APOC跳过了错误的映射规则解析，不会触发异常逻辑。添加name属性无效，因为错误根源并非节点缺少该属性，而是映射配置的格式问题。

验证结果 #

使用上述配置后，导入的Earthquake节点的coordinates属性会被正确转换为包含高度的Point类型，你可以通过以下Cypher查询验证：

MATCH (e:Earthquake) RETURN e.coordinates, point.y(e.coordinates) AS height

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