已启动NameNode和DataNode，HDFS创建目录失败求助及调试方法咨询

刚入门大数据遇到这种问题很正常，咱们一步步来排查和解决：

第一步：先抓准错误信息 #

你现在只说命令失败，但没提到具体的报错内容——错误提示是定位问题的核心。比如是权限被拒绝？还是连不上NameNode？执行命令时把完整的错误输出复制下来，比如类似这样的：

Permission denied: user=your_username, access=WRITE, inode="/usr":hdfs:supergroup:drwxr-xr-x

常见原因及解决方法 #

1. 权限不足（最常见的新手问题） #

HDFS的根目录/默认只有hdfs超级用户有写权限，普通用户直接在根目录下创建/usr目录会被拒绝。

解决方式有几种：

• 切换到hdfs用户执行命令：

  su - hdfs
  ./hdfs dfs -mkdir -p /usr/master/datas
  

• 在自己的用户目录下创建（推荐）：
  HDFS默认会为每个系统用户分配/user/你的用户名目录，你有完全的读写权限，所以可以改成：

  ./hdfs dfs -mkdir -p /user/your_username/datas
  

• 临时开放根目录权限（仅测试环境用）：
  如果只是测试，不想切换用户，可以让hdfs用户给根目录开放写权限（生产环境绝对不建议这么做）：

  su - hdfs
  hdfs dfs -chmod 777 /
  exit
  # 然后再用你的普通用户执行mkdir命令
  

2. NameNode或DataNode状态异常 #

你说已经启动了服务，但可能NameNode没进入Active状态，或者DataNode没正常连接：

• 用jps命令检查进程是否存在：

  jps
  

  正常应该能看到NameNode、DataNode这两个进程。
• 用hdfs dfsadmin -report查看集群状态：

  hdfs dfsadmin -report
  

  重点看NameNode status是否是Active，以及Live datanodes的数量是否正常（至少1个）。如果NameNode是Standby，那需要切换到Active；如果DataNode没上线，检查DataNode的日志找原因。

3. HDFS配置问题 #

如果NameNode的地址配置不对，命令可能连不上集群：

• 检查core-site.xml中的fs.defaultFS配置，确保指向正确的NameNode地址，比如：

  <property>
      <name>fs.defaultFS</name>
      <value>hdfs://localhost:9000</value>
  </property>
  

• 如果配置没问题但还是连不上，可以在命令里手动指定NameNode地址：

  ./hdfs dfs -fs hdfs://localhost:9000 -mkdir -p /usr/master/datas
  

调试小技巧 #

• 先执行简单命令测试连通性，比如./hdfs dfs -ls /，如果这个命令也失败，说明是集群连接或权限的基础问题；如果能成功列出根目录内容，再排查mkdir的路径问题。
• 查看HDFS日志，日志一般在$HADOOP_HOME/logs目录下，比如hadoop-hdfs-namenode-xxx.log和hadoop-hdfs-datanode-xxx.log，里面会有详细的错误原因。

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