Ubuntu下执行mvn clean javadoc:jar package报JAVA_HOME未正确定义错误怎么办

从你给出的校验结果判断，全局JAVA_HOME配置本身不存在根本性错误：echo $JAVA_HOME输出值符合预期、mvn -v也能正常识别对应路径的JDK运行环境。触发该报错的核心原因不是JAVA_HOME指向错误，而是三个常见偏差叠加导致：

• 之前尝试配置的macOS专用路径写入系统配置后，造成了环境变量冲突
• 当前安装的OpenJDK包缺失javadoc可执行文件，Maven检测不到对应组件
• Maven javadoc插件自身的环境变量读取逻辑，和当前Shell的变量加载链路不统一

• 清理历史错误配置残留
  你之前尝试写入的/etc/launchd.conf/java-11-openjdk-amd64、/usr/libexec/开头的路径都是macOS系统的专用配置路径，Ubuntu环境下不存在对应目录结构，这类配置完全不会被系统识别，还可能污染Shell配置造成变量混乱。需要依次打开~/.bashrc、~/.zshrc、/etc/environment这几个环境变量配置文件，删掉所有错误的JAVA_HOME赋值行，只保留正确的配置项：

  export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
  export PATH=$JAVA_HOME/bin:$PATH
  

  修改完成后执行对应命令让配置即时生效：使用Bash执行source ~/.bashrc，使用Zsh执行source ~/.zshrc。
• 检查javadoc组件的完整性
  执行命令直接确认JDK目录下的javadoc可执行文件是否存在：

  ls $JAVA_HOME/bin/javadoc
  

  如果系统提示文件不存在，说明当前安装的OpenJDK是精简运行版本，缺失javadoc工具，执行下面的命令补全对应组件即可：

  sudo apt install openjdk-11-jdk-doc
  

• 绕过插件的环境变量读取异常
  部分版本的Maven javadoc插件存在类加载逻辑缺陷，无法读取当前Shell会话加载的JAVA_HOME值，反复修改全局配置的收益极低，可以在执行目标命令时显式传入JAVA_HOME路径，直接绕开插件的读取逻辑：

  JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64 mvn clean javadoc:jar package
  

• 最终环境一致性校验
  完成上述操作后，依次执行两个命令确认全局环境没有偏差：
  1. 执行which javadoc，确认输出路径为/usr/lib/jvm/java-11-openjdk-amd64/bin/javadoc
  2. 执行javadoc -version，确认命令可正常输出版本信息，无路径找不到、权限不足的报错

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