如何在cypher-shell中使用NEO4J_PASSWORD环境变量及传递用户名密码？

问题描述 #

已在系统环境变量中配置了NEO4J_USER_ID和NEO4J_PASSWORD，但执行以下cypher-shell命令时均出现认证失败错误：

cypher-shell -d neo4j -f test.cypher

cypher-shell -d neo4j -u $NEO4J_USER_ID -p $NEO4J_PASSWORD -f test.cypher

报错信息："The client is unauthorized due to authentication failure"

解决步骤 #

1. 先确认环境变量是否生效 #

不同系统的检查命令不一样：

• Windows（CMD）：

  echo %NEO4J_USER_ID%
  echo %NEO4J_PASSWORD%
  

  （PowerShell）：

  $env:NEO4J_USER_ID
  $env:NEO4J_PASSWORD
  

• Linux/macOS：

  echo $NEO4J_USER_ID
  echo $NEO4J_PASSWORD
  

如果输出为空，说明环境变量没生效——设置环境变量后必须重启终端，或者手动加载配置文件（比如Linux下执行source ~/.bashrc或source ~/.zshrc）。

2. 注意Cypher-Shell默认识别的环境变量名 #

Cypher-Shell官方默认只认NEO4J_USERNAME和NEO4J_PASSWORD这两个变量名，你用的NEO4J_USER_ID不被识别，这大概率是认证失败的核心原因。

解决方法二选一：

• 直接修改系统环境变量名，把NEO4J_USER_ID改成NEO4J_USERNAME，重启终端后再执行命令
• 临时映射变量：在执行命令前先导出正确的变量名，或者直接在命令前指定：

  # 方法A：先导出变量再执行
  export NEO4J_USERNAME=$NEO4J_USER_ID
  export NEO4J_PASSWORD=$NEO4J_PASSWORD
  cypher-shell -d neo4j -f test.cypher
  
  # 方法B：命令行临时指定
  NEO4J_USERNAME=$NEO4J_USER_ID NEO4J_PASSWORD=$NEO4J_PASSWORD cypher-shell -d neo4j -f test.cypher
  

3. 简化命令：直接用默认环境变量 #

当NEO4J_USERNAME和NEO4J_PASSWORD正确配置且生效后，无需在命令中指定-u和-p参数，直接执行：

cypher-shell -d neo4j -f test.cypher

即可自动读取环境变量完成认证。

4. 排查其他可能的认证问题 #

• 确认环境变量中的用户名、密码和Neo4j数据库的实际账号完全匹配，注意大小写、特殊字符（比如密码里的空格、符号是否正确转义）
• Windows系统下，区分系统变量和用户变量，确保当前登录用户能读取到你设置的环境变量

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