【Neo4j】图数据库通过浏览器加载csv文件导入踩坑记录

【Neo4j】图数据库通过浏览器加载csv文件导入踩坑记录

坑1：Docker挂载目录后，Neo4j读不到文件（进程缓存问题）

• 现象：宿主机import目录有文件，容器内ls能看到，但Neo4j报22N43；
• 根本原因：Neo4j启动时缓存了import目录"空"的状态，未主动重新扫描目录变化；
• 解决：首次放文件后重启容器（仅需一次，后续放文件无需重启）。

坑2：文件属主不匹配（容器内Neo4j非root运行）

• 现象：文件权限644但仍读不到；
• 根本原因：Docker内Neo4j以neo4j用户（UID=7474）运行，宿主机文件属主是root:root，即使权限644也会被限制；
• 解决 ：chown 7474:7474 /xxx/neo4j/import/xxx.csv（对应容器内neo4j用户）。

坑3：文件权限位意外被修改（chown触发umask掩码）

• 现象：改属主后权限从644变成700（-rwx------）；
• 根本原因：CentOS默认umask=0077，修改属主时会覆盖默认权限，导致仅属主可访问；
• 解决 ：改完属主后必须补设权限：chmod 644 /xxx/neo4j/import/xxx.csv。

坑4：CentOS SELinux安全标签拦截（最核心的隐藏坑）

• 现象：权限/属主都正确，仍报22N43；
• 根本原因：文件SELinux标签为unlabeled_t，SELinux强制拒绝容器进程访问；
• 解决 ：给目录打合法标签：chcon -Rt svirt_sandbox_file_t /xxx/neo4j/import（新文件自动继承标签）。

坑5：Docker版Neo4j路径解析bug（最后一道坎）

• 现象：所有权限/标签都修复，仍报22N43；
• 根本原因 ：部分Neo4j镜像对file:///xxx.csv相对路径解析有bug，无法映射到import目录；
• 解决 ：用容器内完整绝对路径：file:///var/lib/neo4j/import/xxx.csv。

后续避坑核心指南（一句话搞定所有）

以后往/xxx/neo4j/import放CSV文件，只需执行以下3条命令，再也不踩坑：

# 1. 复制文件到import目录
cp 你的文件.csv /data2/neo4j/import/
# 2. 改属主+权限（一步到位）
chown 7474:7474 /data2/neo4j/import/你的文件.csv && chmod 644 /data2/neo4j/import/你的文件.csv
# 3. Neo4j执行时用绝对路径
# LOAD CSV WITH HEADERS FROM "file:///var/lib/neo4j/import/你的文件.csv" AS row RETURN row;

1. SELinux标签仅需给目录执行一次chcon，后续新文件自动继承，不用重复执行；
2. 容器重启/服务器重启都不影响，文件和配置全持久化；
3. 若换服务器/重建容器，只需重新执行chcon打标签+改文件属主/权限即可。