macOS Monterey下Hadoop上传文件报webhdfs LISTSTATUS服务端错误

运行macOS Monterey的设备已完成Hadoop安装，可正常访问localhost的Hadoop管理界面，执行文件上传操作时，界面返回错误提示：

Failed to retrieve data from /webhdfs/v1/?op=LISTSTATUS: Server Error

按优先级从高到低依次排查：

• 先确认HDFS核心进程状态
  打开终端执行jps命令，检查输出结果中是否存在NameNode、DataNode两个核心进程。如果缺少DataNode进程，基本是多次执行hdfs namenode -format导致NameNode和DataNode的clusterID不匹配导致的：找到你在core-site.xml中配置的hadoop.tmp.dir对应路径，删除路径下dfs/name、dfs/data两个目录的全部内容，重新执行一次hdfs namenode -format，重启所有Hadoop服务即可恢复。
• 校验WebHDFS相关配置
  打开Hadoop配置目录下的hdfs-site.xml，确认WebHDFS功能已开启，本地测试环境可暂时关闭HDFS权限校验避免拦截，添加/修改如下配置项：

  <property>
    <name>dfs.webhdfs.enabled</name>
    <value>true</value>
  </property>
  <property>
    <name>dfs.permissions.enabled</name>
    <value>false</value>
  </property>
  

  修改完成后重启HDFS服务。
• 排查JDK版本兼容性问题
  macOS Monterey环境下如果安装了JDK17及以上版本，和3.3.1及更早版本的Hadoop会存在模块访问限制冲突，如果Hadoop日志中出现InaccessibleObjectException相关报错，可二选一解决：要么将本地Hadoop依赖的JDK版本降级到JDK11，要么在hadoop-env.sh配置文件中添加JVM启动参数放开模块限制：

  export HADOOP_OPTS="--add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.io=ALL-UNNAMED --add-opens java.base/java.util=ALL-UNNAMED"
  

• 通过日志定位具体根因
  前端返回的Server Error是通用提示，直接进入Hadoop安装目录下的logs文件夹，查看报错时间点对应的NameNode、DataNode日志，搜索ERROR级别的日志条目，可直接定位到磁盘空间不足、端口占用、本地目录权限不足等具体问题。
• 验证核心接口可用性
  终端执行hdfs dfs -ls /命令测试HDFS基础功能：如果命令行执行同样报错，说明问题出在HDFS核心服务，和Web界面无关；如果命令行可正常列出根目录内容，清空浏览器缓存后重新访问管理界面即可，部分场景是浏览器缓存了过期的鉴权信息导致接口报错。

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