导入大CSV至Neo4j失败：null属性值致Merge节点出错

问题原因 #

大CSV文件中存在nation字段为空的行，而MERGE节点时不能将null作为属性值（MERGE需要明确的匹配条件，null无法匹配任何已存在或待创建的节点），小文件无此类空值所以运行正常。

解决方法 #

方法1：过滤空值行

如果不需要导入nation为空的用户数据，直接用WHERE子句排除：

LOAD CSV WITH HEADERS FROM "file:/Users/mac/Desktop/Dataset.csv" AS row
WHERE row.nation IS NOT NULL
MERGE (u:User {name: row.user, nationality: row.nation})
MERGE (l:Location {name: row.location, region: row.region})
MERGE (u)-[t:to {date: row.DateReview, rating: row.rating}]->(l)
RETURN u, l, t

方法2：给空值设置默认值

如果需要保留这些数据，用coalesce函数给空的nation设置默认值（比如"Unknown"）：

LOAD CSV WITH HEADERS FROM "file:/Users/mac/Desktop/Dataset.csv" AS row
MERGE (u:User {name: row.user, nationality: coalesce(row.nation, "Unknown")})
MERGE (l:Location {name: row.location, region: row.region})
MERGE (u)-[t:to {date: row.DateReview, rating: row.rating}]->(l)
RETURN u, l, t

方法3：拆分MERGE与属性设置

如果希望User节点仅通过name匹配（nationality作为可选属性），先MERGE必填属性，再用SET添加可选属性：

LOAD CSV WITH HEADERS FROM "file:/Users/mac/Desktop/Dataset.csv" AS row
MERGE (u:User {name: row.user})
SET u.nationality = row.nation  # 空值会直接存储为null，不影响MERGE
MERGE (l:Location {name: row.location, region: row.region})
MERGE (u)-[t:to {date: row.DateReview, rating: row.rating}]->(l)
RETURN u, l, t

额外建议 #

• 先检查CSV文件，确认空值出现的位置和原因，比如是否是数据缺失或格式错误
• 导入大文件时，可添加USING PERIODIC COMMIT（Neo4j 4.x及以上版本默认自动处理，旧版本需手动添加）避免内存溢出：

USING PERIODIC COMMIT 1000
LOAD CSV WITH HEADERS FROM "file:/Users/mac/Desktop/Dataset.csv" AS row
...  # 后续逻辑同上

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