Neo4j 3.3.3 CSV导入Merge报错sPOS为NULL，实际无空值且Create可用

我之前在维护老版本Neo4j的时候也碰到过类似的坑，尤其是3.3.x这类较早的版本，MERGE的空值校验逻辑确实有点“敏感”，明明CSV里看着没空值，却偏偏报这个错。结合你的情况，给你几个针对性的排查和解决思路：

• 先排查CSV里的隐性空白/不可见字符
  你说CSV里没有sPOS的NULL值，但大概率是存在前后空格、制表符或者其他不可见字符，Neo4j 3.3.3对这类字符的识别很严格，会直接判定为null。建议用Notepad++这类编辑器打开CSV，开启“显示所有字符”（视图→显示符号→显示所有字符），检查sPOS列的每一行有没有多余的空格或换行。
  处理起来也简单，在Cypher里给sPOS字段加个trim()清洗：

  LOAD CSV WITH HEADERS FROM 'file:///your_test.csv' AS row
  MERGE (n:YourNodeLabel {sPOS: trim(row.sPOS)})
  

• 拆分MERGE语句，降低校验复杂度
  旧版本Neo4j的MERGE如果同时处理多个属性，只要其中一个被误判为null就会触发错误，但CREATE不会做这个校验。你可以把MERGE拆成两步：先基于sPOS这个核心属性做MERGE，再用ON MATCH/ON CREATE处理其他字段，这样能规避其他字段的干扰：

  LOAD CSV WITH HEADERS FROM 'file:///your_test.csv' AS row
  MERGE (n:YourNodeLabel {sPOS: row.sPOS})
  ON CREATE SET n.otherProperty = row.otherProperty
  ON MATCH SET n.otherProperty = coalesce(n.otherProperty, row.otherProperty)
  

• 明确指定CSV解析规则
  Neo4j 3.3.3的CSV解析器对分隔符、引号的默认处理可能和你的文件格式不匹配。比如如果你的字段是用双引号包裹的，或者分隔符不是默认的逗号，最好在LOAD CSV里明确声明：

  LOAD CSV WITH HEADERS FROM 'file:///your_test.csv' AS row 
  FIELDTERMINATOR ',' 
  QUOTE '"'
  MERGE (n:YourNodeLabel {sPOS: row.sPOS})
  

  另外，把CSV保存为UTF-8无BOM格式，也能避免编码问题导致的解析异常。

• 先验证导入数据的真实性
  你可以先跑个小查询确认Neo4j实际读取到的sPOS值是不是真的有null：

  LOAD CSV WITH HEADERS FROM 'file:///your_test.csv' AS row
  RETURN row.sPOS, count(*) AS count
  WHERE row.sPOS IS NULL
  

  如果返回结果有计数，说明确实存在被识别为null的行，再针对性清洗；如果没返回，那就是版本的MERGE特性问题，用拆分语句的方法就能解决。

内容的提问来源于stack exchange，提问作者David A Stumpf