Hadoop Web UI中WebHDFS文件预览失败问题求助

针对你遇到的单节点Hadoop 3.3.1-RC3版本Web UI预览文件报错、但hdfs dfs命令正常的问题，尝试以下排查和解决步骤：

• 检查DataNode的WebHDFS核心配置
  确保hdfs-site.xml中已开启WebHDFS并正确配置DataNode的HTTP地址：

  <property>
      <name>dfs.webhdfs.enabled</name>
      <value>true</value>
  </property>
  <property>
      <name>dfs.datanode.http.address</name>
      <value>0.0.0.0:9864</value> <!-- 替换为你的主机IP或0.0.0.0以允许所有地址访问 -->
  </property>
  

  修改后重启DataNode服务：

  hadoop-daemon.sh stop datanode
  hadoop-daemon.sh start datanode
  

• 验证WebHDFS端点的可用性
  用curl直接测试DataNode的WebHDFS接口，确认服务端是否正常响应：

  curl "http://你的主机IP:9864/webhdfs/v1/user/lemit/output/part-r-00000?op=OPEN&namenoderpcaddress=localhost:9000&length=32768&offset=0"
  

  • 如果curl能返回文件内容，说明问题出在浏览器端的主机名解析或跨域；
  • 如果curl报错，检查防火墙是否开放9864端口，或用jps命令确认DataNode进程是否正常运行。

• 修正主机名解析异常
  错误链接中的主机名desktop-ht79hb0.末尾带点，大概率是Hadoop配置中的主机名设置错误：

  1. 检查core-site.xml的fs.defaultFS配置，确保格式为hdfs://localhost:9000或hdfs://desktop-ht79hb0:9000（主机名不要带末尾的点）；
  2. 修正/etc/hosts文件，添加正确的主机名映射：

     127.0.0.1   localhost desktop-ht79hb0
     你的实际IP   desktop-ht79hb0
     

  3. 重启所有Hadoop服务：

     stop-all.sh
     start-all.sh
     

• 处理跨域访问限制
  如果浏览器控制台提示跨域相关错误，在hdfs-site.xml中添加跨域支持配置：

  <property>
      <name>dfs.webhdfs.cors.enabled</name>
      <value>true</value>
  </property>
  <property>
      <name>dfs.webhdfs.cors.allowed.origins</name>
      <value>*</value> <!-- 可指定具体域名，如http://localhost:50070 -->
  </property>
  

  重启NameNode和DataNode后重新测试。

• 确认文件及目录权限
  虽然hdfs dfs能正常访问，但WebHDFS使用HTTP用户身份访问，需确保文件和父目录权限足够：

  hdfs dfs -chmod 755 /user/lemit/output
  hdfs dfs -chmod 644 /user/lemit/output/part-r-00000
  

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